Page History

Prerequisites

• Ensure your machine meets the minimum system requirements for running the modeling tool.

• An appropriate JVM version should be installed on your machine (optional).

• IMPORTANT for DSLS licensing. Microsoft Visual C++ Redistributable must be installed (see Latest supported Visual C++ Redistributable downloads). This applies to Windows OS only.

• You have the installation files.

Installation workflow

1. Install the modeling tool following the installation instructions according to your operating system.

   Note
   title Demo Version files
   Starting with 19.0 SP2, Demo version comes as a separate install file and does not require the license key.

2. Add the license key or obtain the floating license.
   
   

You must install the desktop software on your computer to use the modeling tool. The installation procedures provided below are for the standard installation as well as the advanced. However, it is strongly recommended to use the standard installation procedure.

Installing on Windows

Standard installation

1. Double-click the installer.
2. If the User Account Control dialog appears asking permission for the installer to make changes in your computer, click Yes.
3. Follow the on-screen instructions.

4. Start the modeling tool by doing one of the following:

   Note
   title Important
   We recommend starting the modeling tool as an administrator. Right-click the <modeling tool>.exe file. Select Run as administrator from the shortcut menu.

   • On the taskbar in Windows, click the Start button, and then, click the modeling tool (for example, MagicDraw).

   • Open the <modeling tool> installation\bin folder and double-click the modeling tool .exe file (for example, magicdraw.exe).

5. In the Import Configuration dialog, do one of the following:
   • If you want to import the environment options from an earlier modeling tool version, select the location and click Import.
   • If you want to use the default environment options, click Use Default.
6. Add the license key or obtain the floating license.

Installation using no-installer

1. Extract <modeling tool>_<version number>_no_install.zip.
2. Set Java home:
   1. Open the <modeling tool>.properties file, which can be found in <modeling tool>_<version number>_no_install\bin folder.
   2. In the JAVA_HOME line, add the path to the Java software. For example:
      JAVA_HOME=C\:\\Program Files\\Java\\jdk11.0.9
3. To start the modeling tool, open the <modeling tool>_<version number>_no_install\bin folder and double-click the <modeling tool>.exe file.
4. In the Import Configuration dialog, do one of the following:
   • If you want to import the environment options from an earlier modeling tool version, select the location and click Import.
   • If you want to use the default environment options, click Use Default.
5. Add the license keyor obtain the floating license.

Installing on OS X

Standard installation

1. Double-click the installer.
2. In the modeling tool installation window, drag the <modeling tool> folder to the Applications folder.
3. Close the modeling tool installation window.
4. Start the modeling tool. Open the Application / <modeling tool> installation folder and double-click the modeling tool .app file (for example, MagicDraw.app).
5. In the Import Configuration dialog, do one of the following:
   • If you want to import the environment options from an earlier modeling tool version, select the location and click Import.
   • If you want to use the default environment options, click Use Default.
6. Add the license keyor obtain the floating license.

   
   

Installation using no-installer

1. Extract <modeling tool>_<version number>_no_instal.zip.
2. Set Java home:
   1. Open the <modeling tool>.properties file, which can be found in <modeling tool>_<version number>_no_install\bin folder.
   2. In the JAVA_HOME line, add the path to the Java software. For example:
      JAVA_HOME=/Users/<user_name>/Library/Java/JavaVirtualMachines/jdk11.0.9.jdk/Contents/Home/
3. To start the modeling tool, open the <modeling tool>_<version number>_no_install folder and double-click the <modeling tool>.app file.
4. In the Import Configuration dialog, do one of the following:
   • If you want to import the environment options from an earlier modeling tool version, select the location and click Import.
   • If you want to use the default environment options, click Use Default.
5. Add the license keyor obtain the floating license.

Installing on Unix

Standard installation

1. From the <modeling tool>_<version number>_unix.sh shortcut menu, select the Properties command and then click to select the Allow executing file as program check box. 
2. Double-click the installer.
3. Follow the on-screen instructions to install the modeling tool.
4. Start the modeling tool. Open the <modeling tool> installation/bin folder and double-click the modeling tool file (for example, magicdraw).
5. In the Import Configuration dialog, do one of the following:
   • If you want to import the environment options from an earlier modeling tool version, select the location and click Import.
   • If you want to use the default environment options, click Use Default.
6. Add the license keyor obtain the floating license.

   
   

Installation using no-installer

1. Extract <modeling tool>_<version number>_no_install.zip.
2. Set Java home:
   1. Open the <modeling tool>.properties file, which can be found in <modeling tool>_<version number>_no_install\bin folder.
   2. In the JAVA_HOME line, add the path to the Java software. For example:
      JAVA_HOME=/usr/local/java/jre11.0.9
3. To start the modeling tool, open the <modeling tool>_<version number>_no_install/bin folder and double-click the <modeling tool> file.
4. In the Import Configuration dialog, do one of the following:
   • If you want to import the environment options from an earlier modeling tool version, select the location and click Import.
   • If you want to use the default environment options, click Use Default.
5. Add the license keyor obtain the floating license.

Bundling JRE for multiple operating systems

If you want to configure the modeling tool for multiple operating systems, you can manually customize the <modeling tool>.properties file in order for the tool to automatically detect the relevant operating system upon its launch. This eliminates the need to customize the JRE path on each individual operating system where the bundled modeling tool is used. 

1. Open the <modeling tool>.properties file, which can be found in <modeling tool>_<version number>_no_install\bin folder.
2. In the JAVA_HOME line, add the path to the Java software for a specific operating system. Duplicate the line for any additional operating systems you may be using, adding their relative paths. For example:

JAVA_HOME_WINDOWS=jre/windows
JAVA_HOME_MACOSX=jre/macosx/mac/Contents/Home/jre
JAVA_HOME_LINUX=jre/linux

When you are finished with the installation, the following page will provide you with more information on setting up your modeling tool:

• Installing plugins

If you will be using a floating license server, all relevant information can be found here:

• FlexNet license server installation and licensing

If you run into further problems with installation, please try:

• checking the FAQ section for known problems
• checking the No Magic Community forum
• or contacting customer support.