no magic catia logo

Installation and Running

Please start the installer with the following parameters:

The example:

MD_UML_169_win.exe -i silent "-DUSER_INSTALL_DIR=C:\Program Files\MagicDraw 16.9"
MagicDraw will be installed silently, with a default configuration.

Reinstall product on new computer:

  1. Deactivate the current license.
  2. Download and install the fresh installation on new machine.
  3. Start it after the installation is finished.
  4. The Import Configuration dialog will appear upon opening installation for the first time. In the dialog, type the path to the installation folder of an older installation to import program configurations from it.
  5. Uninstall the product from old machine.
  6. You will be requested to activate the license and receive the commercial license dedicated for the particular machine.

This is a known issue in Intel based Mac OS with QuickTime 7.2 update that causes most of the Power PC applications to refuse to start. This problem hounts some Java apps too, and sometimes MagicDraw refuses to start from the icon created by the installer. Although it is possible to start MagicDraw from command line (look for classpath and JVM flags from Indo.plit file).

There is available one solution that fixes the Power PC apps and also the MagicDraw from here:

The fix involves some command-line and text editor usage, but it's relatively simple and it works.

This problem is Install Anywhere related and appears when you uninstall previous version of MagicDraw and then, without restarting your computer, install another MagicDraw in the same directory. We would suggest to uninstall MagicDraw, restart your computer, and then install MagicDraw again.

On the Macintosh, MagicDraw points out error at startup:

at sun.java2d.SunGraphicsEnvironment.getAvailableFontFamilyNames(SunGraphic
at sun.java2d.SunGraphicsEnvironment.getAvailableFontFamilyNames(SunGraphic
at com.nomagic.actions.SetFontFaceAction.(
at com.nomagic.actions.SetFontAction.(


Based on messages from the Apple java-dev mailing archive, a lot of people who use Java 1.4.1 on Mac have experienced similar problems. Someone suggested this had to do with bitmap fonts in a Classic install in "/System Folder/Fonts". And it seems that renaming "/System Folder/Fonts/" to "/System Folder/Fonts.not/" or something else and rebooting your machine can solve the problem.

You can save configuration files in the modeling tool installation directory or on your chosen directory.

To store configuration files in the modeling tool installation directory add argument into JAVA_ARGS line in file *.properties* (this file is in \bin):

NOTE: For Windows users. If you are using MagicDraw 17.0.4 or later, you must also add argument

To store configuration files to your chosen location

  1. In the /.<modeling tool name>/ folder, create file named  <modeling tool properties file name> redirect, that is magicdrawredirectcameoearedirectcsmredirect, or cbmredirect.
  2. In the created file, type absolute (for example, C:\users\john\Documents) or relative (relative to modeling tool installation directory, for example, ..\configurations) path where configuration and auxiliary files will be saved.


  1. Open the *.properties* file, which is located in \bin.
  2. Add the parameter value to the end of the line started with JAVA_ARGS= -Dlocalconfig.location=<absolute path to a custom location>

For example, -Dlocalconfig.location\=C\:\\MagicDraw\\configurationData

NOTE: If there is defined to store files in installation directory (see the section "To store MagicDraw configuration files in MagicDraw installation directory" above), files will not be stored to your chosen location.

* For more information about configuration files please, see Configuration files

Please check if the file is not truncated. You can see the exact file size at the download page.

In most cases such error appears when installer file is truncated or corrupted.

Please try to download an installer again.

Another option is that /usr/bin/java is an old version java. To check which java is used by installer, set environment variable LAX_DEBUG and launch installation again.

By default installer first uses java found in /usr/bin. But there is possibility to use specific VM when launching the installer. Please add parameter LAX_VM to launcher and second parameter path to java executable, here is an example (assuming that java is in /opt/j2sdk1.5.0_03):

./ LAX_VM /opt/j2sdk1.5.0_03/bin/java

Run mduml* file, which is located in MagicDraw installation directory, bin folder.


* If you are using MagicDraw 17.0.5 or later, the name of the property file is

We have found that update of JAVA for Mac OS triggers the problem with disappearing MagicDraw menu. This issue is fixed in 16.5 SP3. Also we suggest two workarounds:

  1. You need to define older JAVA version in* ( /bin/ ) file and work with that JAVA version (for example version 1.5.0 or previous 1.6.0).
  2. You need to change Look & Feel style by editing global.opt file. Note: This problem does not exist on Metal Look & Feel.

Steps how to do that:

  • Shutdown MagicDraw application;
  • Go to ./magicdraw/ /data/;
  • Open global.opt file with text editor;
  • Find LOOK_AND_FEEL_CLASS propertyID.
  • Replace tag apple.laf.AquaLookAndFeel with new one:
  • Save file;
  • Start MagicDraw application.

* If you are using MagicDraw 17.0.5 or later, the name of the property file is

Save error appears saving project with modules when MagicDraw v16.6 is installed on top of MagicDraw v15.0 or earlier (using autoupdate functionality). This problem occurs because one or more old resource descriptors from MagicDraw v15.0 or earlier are corrupted.

To prevent MagicDraw project save error you need to install MagicDraw v16.6 to a new location – to a new and empty folder, for example, "MagicDraw 16.6". Note that on the first MagicDraw startut you can import MagicDraw environment options from previous MagicDraw installations.

You may download MagicDraw 16.6 from your personal or company profile on, also to obtain unlock keys.

First of all you need to pre-configure MagicDraw. Do the following:

  1. Check if you have the permission to write to the MagicDraw installation folder because all information that you change will be stored in this folder. If you do not have the permission to write, contact your system administrator.
  2. In, which is in \bin, set the parameter value:
  3. Run MagicDraw and set desired options, then close the program.
  4. Reopen and restore the parameter value JAVA_ARGS=-DLOCALCONFIG\=true and remove the parameter -DWINCONFIG\=false.
  5. Copy the MagicDraw installation folder and paste it on a new machine.

Let us explain the difference between changed parameter values:

a) If JAVA_ARGS=-DLOCALCONFIG\=true, then option settings are stored in \.magicdraw\ . Options are loaded in the following order:

  1. From <Common Application Data location>\.magicdraw\
  2. From the MagicDraw installation folder

b) If JAVA_ARGS=-DLOCALCONFIG\=false -DWINCONFIG\=false, then option settings are stored only in the MagicDraw installation folder and are loaded from there.

The proper way to activate the license is to install the application as the administrator, then to login as a regular user, which will use the tool, and proceed with the license activation process.

The particular user licensing information is stored in the user home directory. So if you want that the application which has already been activated from the administrator account would not require the license activation from the user account on the same machine, you should change the licensing information storage place.

You can store the licensing information in the MagicDraw installation directory (the read-write rights are required).

For the instructions on how to change the configuration files directory, please find the issue "In our company the storage of user home directory is limited. How to force to keep configuration files in other directory?"

Note: It is important to know that the MagicDraw seat license can be used by a single user only.

In order to fix the problem with the menu bar after java update on the Mac OS, you need to open /.magicdraw/16.6/data/global.opt and change the string "" to "apple.laf.AquaLookAndFeel".

After updating MagicDraw to version 17.0.1 exceptions can be shown on different actions. The exception stack trace may look like :

java.lang.RuntimeException: java.lang.reflect.InvocationTargetException
at com.nomagic.utils.Utilities.invokeAndWaitOnDispatcher(
at com.nomagic.magicdraw.core.project.ProjectsManager.setActiveProject(ProjectsMana


at com.nomagic.magicdraw.core.project.ProjectsManager.fireProjectPreActivated(Proje
at com.nomagic.magicdraw.core.project.ProjectsManager$ 9)
at com.nomagic.utils.Utilities.invokeAndWaitOnDispatcher(

You are using incompatible plugin e.g. Cameo Simulation Toolkit 1.1, Cameo Data Modeler 16.8, EstimIX, ExtendIX, or other. Those plugin versions are not compatible with MagicDraw 17.0.1.

Please update or remove incompatible plugins from Help > Resource/Plugin Manager > Click the button "Check For Updates" > and download compatible version OR remove incompatible plugin from the MagicDraw.

Plugins compatibility can be checked here.

To see the pallet, you need to upgrade your MagicDraw to a new version of 17.0 SP1.

To upgrade MagicDraw to the new version of 17.0 SP1:

  1. On the main menu, click Help > Check For Updates.
  2. Click Apply Patch.
  3. Restart MagicDraw.

When Resource/Plugin Manager is started error is shown:


MagicDraw up to version 17.0.1 SP1 with Java version 1.7 is used.

This issue is 1.7 Java specific.

We highly recommend to use the bundled Java, which comes with MagicDraw installation (select to use the bundle Java in third MagicDraw installer step).

Java can be changed in* file in "JAVA_HOME=" line.* can be found in "MagicDraw install dir" / bin folder.

This issue is already fixed in v17.0.1 SP1

* If you are using MagicDraw 17.0.5 or later, the name of the property file is

The following issues appear:

  • MagicDraw hangs on a splash screen.
  • Any model or diagram cannot be opened.
  • Any diagram or element cannot be created.
  • In the md.log file, the exception "net.sf.ehcache.CacheException" appears.

What should I do?

To start MagicDraw normally, perform the following steps:

  • Update MagicDraw into 17.0 SP3 or
  • Delete all cache folders from user home directory > /.magicdraw/ version > / and restart MagicDraw.

Note: Upgrading the Mac OS X to 10.6.5, upgrades Java to version 1.6.0_26 automatically.

You may find all the information about updating to new version at Updating modeling tools and plugins.

This error occurs when you have a corrupted installer file. Please download the file and install again.

We recommend running MagicDraw as an administrator and with enabled UAC (User Account Control) on Windows Vista, Windows 7 and Windows 8 OS in order to avoid some problems that are related with permissions to modify files on the MagicDraw installation root directory.

To enable UAC on Windows 7, Windows 8, or Windows 10 OS, do the following:
1. Click the Start button, type “msconfig” in the Search box and press Enter.
2. From the System Configuration dialog, click the Tools tab.
3. Select the Change UAC Settings tool and click Launch button.
4. Move the slider to the highest value to set Always notify and click OK.
5. Restart the computer to apply changes.

To enable UAC on Windows Vista OS, do the following:
1. Click the Start button, type “msconfig” in the Search box and press Enter.
2. From the System Configuration dialog, click the Tools tab.
3. Select the Enable UAC tool and click Launch button. The CMD window opens.
4. When the command is completed, you can close CMD window.
5. Restart the computer to apply changes.

To run MagicDraw as administrator, right-click the MagicDraw icon and choose Run as Administrator.

To run MagicDraw as an administrator all the time, do the following:
1. Right-click the MagicDraw icon and choose Properties.
2. Click the Compatibility tab.
3. In the Privilege Level area, select Run this program as an administrator.
4. Click OK.

Please note that downloaded installs are not corrupted or damaged and this problem is not related to the MagicDraw application. This issue is related to the new OS X Mountain Lion functionality, "Gatekeeper."

The Gatekeeper functionality, by default, does not allow executing applications that are not from the Apple Store or from Identified Developers.

In order to launch MagicDraw, users can modify the option, which allows executing all the applications from all the providers. For more information on how to do this, go to:

Note: We are communicating with Apple to solve this issue so that our customers may execute MagicDraw without any problems.

We offer you to solve the problem in one of the following ways.

Solution #1:

  1. Remove from <MagicDraw 17.0.3 SP1 installation directory>.
  2. Extract to <MagicDraw 17.0.3 SP1 installation directory>. Select to overwrite all files, when you will be asked. A new file will appear in <MagicDraw 17.0.3 SP1 installation directory>.
  3. Use the file to start the upgraded version of MagicDraw.

Solution #2:

  1. Extract to <MagicDraw 17.0.3 SP1 installation directory>. Select to overwrite all files, when you will be asked.
  2. Copy the file and paste it in the same directory. The MagicDraw file will appear in <MagicDraw 17.0.3 SP1 installation directory>.
  3. Use the MagicDraw file to start the upgraded version of MagicDraw.

The error appears because the file cannot find the installed Java 6.

To handle the problem, please use one of the following workarounds:

  • Start MagicDraw using the mduml* file that can be found in <MagicDraw installation folder>/bin.
  • Install Java 6 in your computer and use the file to start MagicDraw 17.0.4.

This issue will be fixed in MagicDraw 17.0.5.


* If you are using MagicDraw 17.0.5 or later, the name of the property file is


The problem is that MagicDraw earlier than 17.0.2 SP3 or 17.0.3 SP1 cannot be started on OS X Yosemite.
To start MagicDraw on OS X Yosemite, you must upgrade the modeling tool at least to 17.0.2 SP3 or 17.0.3 SP1.

If MagicDraw still does not start, you must upgrade Java on your computer. For recommended Java versions and links to downloads, please visit

To initialize log4j, open <MagicDraw installation directory>/data, and modify the file.

Change the debug level for appropriate categories by specifying log4j.category.<category>=DEBUG or turn on debug for all categories log4j.rootCategory=DEBUG,SO.

Close your modeling tool, delete all cache folders and start the program again.
Cache folders can be found in <user home directory>\.<modeling tool>\<version number>, for example <userhome>\.magicdraw\<18.2>.

If the problem still exists, please add the option into the JAVA_ARGS line in the modeling tool properties file, for example A properties file is in <modeling tool installation directory>\bin.

See the example:

JAVA_ARGS=-Xmx4000M -XX\:PermSize\=60M -XX\:MaxPermSize\=200M -DLOCALCONFIG\=true -splash\:data/splash.png -Dmd.class.path\=$java.class.path -Dcom.nomagic.osgi.config.dir\=configuration -Desi.system.config\=data/application.conf -Dlogback.configurationFile\=data/logback.xml -Xss1024K


Mac OS X Sierra has an updated gatekeeper policy. It says that all applications which are downloaded in .zip/iso files are not secure because of the dylib-hijacking problem.
(Please find more about it at
All not secure programs, including the .app part of the application are moved to a temporary directory (quarantine), in other words, the application is improperly located and can not be started.

The solutions are:

  1. To run file from the  /bin directory.
  2. To download the original signed MagicDraw.dmg file and to install the application again.
  3. To remove the program from quarantine.

To remove the application from quarantine, please do:

  1. Open a terminal.
  2. Using the terminal, open the MagicDraw installation directory.
  3. Write the command: xattr -d
  4. Close the terminal and start MagicDraw using the .app file.

NOTE: This issue is fixed for the 18.4 SP1 and 18.0 SP6 versions.

Please restart your computer. After multiple updates or after installing different versions of a modeling tool on the same machine with Mac OS, sometimes it happens for unknown reason.

This is a known issue with Mac OS X 10.11 El Capitan operating system. Most dialogs in the application will be displayed behind previously open dialogs, affecting usability of the user interface. There is no solution to this problem. Please try to downgrade the Mac OS to some earlier version.

Edit the appropriate boot script, which could be one of the following: /etc/rc.boot, /etc/rc.local, /etc/rc2.d/Sxxx, or /sbin/ rc2.d/Sxxxx.

Then, include commands similar to the following:

/bin/su daniel -c 'echo starting lmgrd > \
/bin/nohup /bin/su daniel -c 'umask 022; \
/home/flexlm/v11/hp700_u9/lmgrd -c \
/home/flexlm/v11/hp700_u9/license.dat >> \
/bin/su daniel -c 'echo sleep 5 >> \
/bin/sleep 5
/bin/su daniel -c 'echo lmdiag >>\
/bin/su daniel -c '/home/flexlm/v11/hp700_u9/lmdiag -n -c\
/home/flexlm/v11/hp700_u9/license.dat >> \
/bin/su daniel -c 'echo exiting >>\

Please note that this does not start the vendor daemon until you reboot the system.

For more information or a quote
please contact
or call +1-214-291-9100.