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 all modeling tools that are developed by No Magic, Inc., that is

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

OSConfiguration 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>



Modeling tool file naming

In a file system, modeling tools' folders are named as follows:

Modeling toolFile name
MagicDrawmagicdraw
Cameo Enterprise Architecturecameoea
Cameo Systems Modelercameo.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


  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 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


  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:

 -DLOCALCONFIG=true=false
Windows OSxCommon Application DataModeling 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:

  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 folder, where the configuration files are stored.
  2. Create a new file named magicdrawredirect.

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