no magic catia logo

Java Virtual Machine (JVM)


MagicDraw stops responding due to an issue detected in Java SE 7 Update 40, which is bundled with MagicDraw 17.0.5 (for the issue details, go to

This issue will be fixed in MagicDraw 17.0.5 SP1, coming out in the middle of February.

To solve the issue manually (without the SP), switch the version of the bundled Java to SE 7 Update 25*, which does not cause the issue. For this, do the following:

  1. Open the file, stored in <MagicDraw installation directory>/bin.
  2. Find the JAVA_HOME property and add the path to the location of Java SE 7 Update 25 on your PC. For example, “JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk1.7.0_25.jdk/Contents/Home”.

Please contact our customer support, if this does not help.

* If you do not have Java SE 7 Update 25 installed on your PC, download the installer from the Java SE 7 Downloads page. You need the jdk-7u25-macosx-x64.dmg file.

MagicDraw needs Java to be supported. Java 1.6 is available on the 64-bit Intel-based Macs only. Non-Intel-based PowerPC does not support Java 1.6 and later.

The latest MagicDraw version which can support Java 1.5 is MagicDraw v16.6.

You can watch installation process by setting environment variable LAX_DEBUG to value 1 before starting installation.

The problems are usually related with opening/creating projects. The recommendation is to use JVM 1.5 for MagicDraw v14.0 and previous.

You may find this information in the About window (Help menu -> About)


If you have Sun's or IBM's JVM, enter the following in the command prompt: java -version.

  1. Go to <modeling tool installation directory>\bin and open the <modeling tool>.properties file (eg., for editing. If you are using MagicDraw 17.0.4 or earlier, the name of the property file is
  2. In the JAVA_HOME line, add the path to the Java software. For example: JAVA_HOME=C\:Program Files\\Java\\jre1.8.0_144


NOTE: Integrated MagicDraw runs on the JVM specified by the IDE. In order to change the JVM, you must modify the startup properties for the IDE that MagicDraw integrates with. If you are running MagicDraw integrated with IDE, read the appropriate readme.html for specific integration, found in the integrations folder.

In order to install Java 1.5 on Mac OS X 10.6 Snow Leopard, please follow these steps.

Execute the following commands in the terminal:

1. Get the java 5 that was included in 10.5 "leopard" and unpack:

cd /tmp/

curl -o java.1.5.0-leopard.tar.gz nd/java.1.5.0-leopard.tar.gz.

tar -xvzf java.1.5.0-leopard.tar.gz

2. Move it to your System java folder (password needed):

sudo mv 1.5.0 /System/Library/Frameworks/JavaVM.framework/Versions/1.5.0-leopard

3. Tell OS X that java 5 actually is java 5:

cd /System/Library/Frameworks/JavaVM.framework/Versions/

sudo rm 1.5.0

sudo ln -s 1.5.0-leopard 1.5.0

sudo rm 1.5

sudo ln -s 1.5.0 1.5

After these commands, Java 1.5 will be installed. You can check Java 1.5 on Java Preferences dialog (open "/Applications/Utilities/Java")

Change the properties to use Java 1.5 32-bit on MagicDraw. Open file ""*, which is located in /bin and change path in line JAVA_HOME=.

The line should look like:



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

You can change the java maximum heap size (-Xmx) in your /bin/* file, in the line:


The maximum theoretical heap limit for the 32-bit JVM is 4G. Due to various additional constraints such as available swap, kernel address space usage, memory fragmentation, and VM overhead, in practice the limit can be much lower. On most modern 32-bit Windows systems the maximum heap size will range from 1.4G to 1.6G. On 32-bit Solaris kernels the address space is limited to 2G. On 64-bit operating systems running the 32-bit VM, the max heap size can be higher, approaching 4G on many Solaris systems.

On 64-bit VMs, you have 64 bits of addressability to work with resulting in a maximum Java heap size limited only by the amount of physical memory and swap space your system provides.

More information about OutOfMemory problems you can find in readme.html by "OutOfMemory problem" paragraph. This file is located in <MagicDraw installation directory>.


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

Java version 9 is set as the default system Java after updating Java. This Java version is not supported by our modeling tools*.

The solution is to download and install version 18.4 SP1 or a later original signed .dmg file, as it has the required Java version bundled in.

If you are using an earlier version than 18.4 SP1 and cannot start the modeling tool*, please do the following:

  1. Download the original signed <modeling tool*>.dmg file and install the application again.
  2. In bin\**, set JAVA_HOME to the Java version installed in the <modeling_tool*_installation_directory >\java folder.

Example: JAVA_HOME=/Applications/MagicDraw/jre1.8.0_102/mac/Contents/Home/jre

  1. Run*** file from the /bin folder.

*MagicDraw, Cameo EA, Cameo Systems Modeler



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