Installing modeling tools

 These instructions apply to the following modeling tools produced by No Magic:

• MagicDraw
• Cameo Systems Modeler
• Cameo Enterprise Architecture

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

• You have the installation files downloaded from your account at www.nomagic.com.
  

Installation workflow

1. Install the modeling tool following the installation instructions according to your operating system.
2. Activate the license (for paid commercial seat or mobile licenses only).

3. 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:
   • 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).

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

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.

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\\jdk1.7.0_67\\jre
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.

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.

Installation using no-installer

1. Extract <modeling tool>_<version number>_no_instal.mac.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/jdk1.8.0_92.jdk/Contents/Home/jre
3. To start the modeling tool, open the <modeling tool>_<version number>_no_install_mac 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.

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.

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/jre1.8.0_71
3. To start 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.

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 pages will provide you with more information on setting up your modeling tool:

• Modeling tools and plugins licensing
• 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 the known problems
• checking the No Magic Community forum
• or contacting the customer support at support@nomagic.com
  
  

---

More information about getting ready to work with the modeling tool

For information on working with the modelling tools, please see the following pages.

• MagicDraw Documentation
• Cameo Systems Modeler Documentation
• Cameo Enterprise Architecture Documentation