On this page
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.
This page covers the following modeling tools:
By default the configuration and auxiliary files of a modeling tool are stored in the following location:
OS | Configuration files storage |
---|---|
Windows | C:\Users\<USERNAME>\AppData\Local\.<modeling tool name>\<modeling tool version number> |
Other OS | <user.home>/.<modeling tool name>/< modeling tool version number> |
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
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 | <user.home>/.<modeling tool name>/< modeling tool version number> | Modeling tool installation directory |
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
If you have defined to store files in the modeling tool installation directory, files will not be stored in the defined location.
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>
Sample property value
-Dlocalconfig.location\=E\:\\temp\\innerPack
Or:
- Go to the folder, where the configuration files are stored.
Create a new file named magicdrawredirect.
- In the file, type the absolute path to the folder, wherein modeling configuration files will be saved, e.g., C:/<directory name>.