MagicDraw 18.5 Documentation

Skip to end of metadata
Go to start of metadata

In some situations you may need to perform additional configuration of your modeling tool to allow it to run properly on your system. The following page describes the locations where you can find the configuration files for the tool, how you can modify them and how to change the default storage location for them. 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 topic covers all modeling tools that are developed by No Magic, Inc., that is

Configuring program settings

A configuration file is where the initial parameters and settings of a program are defined. All default parameters' values come with a program installation but you can edit configuration files and define your own values, for example, to define a Java home directory or other. You can use a text or code editor to edit the configuration file. 

You can also change the default location of configuration files. It is needed if you, for example, work with several installations of the same program version, or need that configuration files could be accessible by only certain users or groups regarding the security issues, or other particular cases.

The following procedures will help you to manipulate and set up configurations you need:


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
Cameo Business Modelercameo.business.modeler

 

If you have no information on where the configuration files are located, you can use the following procedure.


 

How to get the exact 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 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  

 

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

Note

The Common Application Data location on Windows Vista/7/8/10 is C:\ProgramData.

  1. Open the <modeling tool name>.properties file, which is located in <modeling tool installation directory>\bin.
  2. Change the parameter value according to the following table:

    Valid, if -DLOCALCONFIG=false
-DWINCONFIG=true=false
Windows OSxCommon Application DataModeling tool installation directory
OtherModeling tool installation directoryModeling 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. 

 

How to store modeling tool configuration files to your 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.

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

Or:

  1. Open the <modeling tool name>.properties file, which is located in <modeling tool installation directory>\bin.
  2. Change the parameter value:
     -Dlocalconfig.location=<absolute path to a custom location>

 

Creating a custom directory for storing configuration files


When working with two or more installations of the same modeling tool version, you may need each of them to have individual configuration files directory (by default, all the installations of the same modeling tool version use a single directory, for example, <...>\.magicdraw\18.4).

In such case, the initial installation of a certain modeling tool version can keep on using the default configuration files directory, that is, <...>\.magicdraw\<version number>, but you must define a custom one for each subsequent installation. For this, edit the modeling tool properties file of each relevant installation by adding the local.config.dir.ext system property. This property requires a textual value to construct the custom directory name. The value of the local.config.dir.ext system property is added as a suffix to the default folder name, for example, “.magicdraw”.

Example

If you need to name the custom configuration files directory “.magicdraw01”, append the magicdraw.properties file with the following line:

local.config.dir.ext=01

Configuration files are stored in <...>\.magicdraw01\<version number>.


 


 

More information about configuring your modeling tool

You can find an example about creating a custom directory for configuration files in a FAQ description.

 If you would like to learn more about configuring the environment or perspectives of your modeling tool, please refer to the following pages:

 

 

  • No labels