A configuration file is where the initial parameters and settings of a program are defined. All default parameter values come with a program installation but you can edit configuration files and define your own values, for example, define the Java home directory. This page describes the locations where you can find the configuration files of your modeling tool, how you can modify them and change their default storage location. Configuration files can be used to:
Define application arguments
Set the Java Home
Change Java parameters (such as memory allocation)
Update default Java classpath (advanced: for plugin developers)
The configuration files can be opened and modified using any standard text or code editor. Once modified, changing the default location of configuration files can allow you to store multiple configuration files for different versions of the tool.
By default the configuration and auxiliary files of a modeling tool are stored in the following location:
OS
Configuration files storage
Windows Vista/7/8/10
C:\Users\<USERNAME>\AppData\Local\.<modeling tool name>\<modeling tool version number>
Other OS
<user.home>/.<modeling tool name>/<modeling tool version number>
Info
title
Modeling tool file naming
In a file system, modeling tools' folders are named as follows:
Modeling tool
File name
MagicDraw
magicdraw
Cameo Enterprise Architecture
cameoea
Cameo Systems Modeler
cameo.systems.modeler
Getting the path to configuration files
If you do not know the exact path to your modeling tool configuration files, follow the steps below to get it.
To get the path to configuration files
From the Help menu, select About <modeling tool name>. The About dialog opens.
Click the Environment tab.
Click the hyperlink next to Configuration Files. The folder containing modeling tool configuration files opens.
You can also save configuration files in any of the following locations:
<modeling tool installation directory>
Common Application Data location (on Windows OS)
Other directory
Storing configuration files in the installation directory or Common Application Data location on Windows
Note
title
Note
The Common Application Data location on Windows Vista/7/8/10 is C:\ProgramData.
To store configuration files in the modeling tool installation directory or Common Application Data location on Windows
Open the <modeling tool name>.properties file, which is located in <modeling tool installation directory>\bin.
In the JAVA_ARGS line, change the -DLOCALCONFIG property value according to the following table:
-DLOCALCONFIG
=true
=false
Windows OSx
Common Application Data
Modeling tool installation directory
Other
Modeling tool installation directory
<user.home>/.<modeling tool name>/<modeling tool version number>
Modeling tool installation directory
Warning
title
Important!
It is important to add the -DWINCONFIG=false parameter on Window OS, otherwise the configuration files will not be stored at the modeling tool installation directory.
You may also store configuration files in your custom location.
Storing configuration files in a custom location
Note
title
Note
If you have defined to store files in the modeling tool installation directory, files will not be stored in the defined location.
excerpt
To store modeling tool configuration files in a custom location
Do either:
Open the <modeling tool name>.properties file, which is located in <modeling tool installation directory>\bin.
In the JAVA_ARGS line, add the following property:
-Dlocalconfig.location=<absolute path to a custom location>