Configuration files

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, and 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 all modeling tools:

• MagicDraw
• Cameo Enterprise Architecture
• Cameo Systems Modeler
• Magic Software Architect
• Magic Cyber Systems Engineer
• Magic Systems of Systems Architect

By default the configuration and auxiliary files of a modeling tool are stored in the following location:

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 the configuration files

1. From the Help menu, select About <modeling tool name>. The About dialog opens.
2. Click the Environment tab.
3. Click the hyperlink next to Configuration Files. The directory 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)
• Another directory

Storing configuration files in the installation directory or Common Application Data location on Windows

To store configuration files in the modeling tool installation directory or Common Application Data location on Windows

1. Open the <modeling tool name>.properties file, which is located in <modeling tool installation directory>\bin.
2. In the JAVA_ARGS line, change the -DLOCALCONFIG  property value according to the following table:
   
   

You may also store configuration files in your custom location. 

Storing configuration files in a custom location

To store modeling tool configuration files in a custom location

Do either:

1. Open the <modeling tool name>.properties file, which is located in <modeling tool installation directory>\bin.
2. 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:

1. Go to the directory, where the configuration files are stored.

2. Create a new file named redirected.location.

3. In the file, type the absolute path to the directory, wherein modeling configuration files will be saved, e.g., C:/<directory name>.

The path in both options (localconfig.location property/redirected.location file) can contain system/environment/application related variables. 

There are only two application related variables:

<env:APPDATA>/configurations/<app:default.config.dir.name>/<sys:user.name>/<app:version>

Installing JxBrowser extensions

 You can install custom browser extensions in JxBrowser as described below.

To install JxBrowser extensions

1. Create a new data/jxbrowser/extensions directory.
2. Add the JxBrowser extension files (.crx) you want to install to the data/jxbrowser/extensions directory.
3. Start or restart your modeling tool.

After completing the above steps, the JxBrowser extensions added to the extensions directory will be installed in all JxBrowser instances.

Related pages

• Customizing environment options
• Customizing and Selecting Perspective