Installation and Use : MagicDraw

Unlocking MagicDraw

Unlock MagicDraw with evaluation, demo, or commercial license key file.

To unlock MagicDraw:

  1. After downloading MagicDraw v16.9 or later, you will get license key file to your mailbox.
  2. Save this key file into the local file system before starting MagicDraw.
  3. When starting MagicDraw for the first time, you will be asked to choose the license key file. Click the Select Licenses Key Files button and select the file from the directory you have saved the file.
  4. System will automatically start MagicDraw and you will be able to use it.

Activating the commercial MagicDraw license after the purchase (v16.9 or later)

The commercial license activation is required after the purchase transaction has been completed. The activation process allows receiving the commercial license dedicated for the particular machine.

NOTES:

  • One license is given for one machine and for one user. If you have activated as Administrator user, other user on the same machine does not take this license. The end-user should activate license.
  • Only commercial activated licenses are locked to the particular machine.
  • During the activation process, identification and registration is required. Any key file (evaluation, demo, commercial not activated and other) can be used for the identification of the license owner.
  • Commercial not activated keys allow using the application for 7 days according to obtained licenses, before requesting activation. Not activated keys can be used during activation process for identification of the account on which the purchases are.

Activating MagicDraw license after the purchase

  1. Click the Activate button in License Manager dialog of the application.
  2. Choose online activation and enable commercial activated (without expiration) licenses automatically.

Alternatively, you may select offline activation, get the Host ID, enter it in the license owner account (login to www.nomagic.com and select License Activation Management menu item at the right side of page) and then download the commercial activated license.

Online activation

  1. Click the Activate button in the License Manager dialog of the application.
  2. If you will be requested, identify yourself and register.
  3. Select licenses you need to activate.

Offline activation

  1. Login to the license owner account on www.nomagic.com.
  2. Click the License Activation Management item in the Members menu.
  3. Click the Create New License Activation Record button and enter user details and Host ID of the machine.
  4. Download or send the key.

Determining a Host ID (for offline activation)

  1. Click the Activate button in the License Manager dialog of the application.
  2. Click Offline Activation.
  3. Host ID is shown.

NOTE: Host ID is the Ethernet address of the machine on which application will run.

More information about the activation process you may find in the Commercial License Activation page.


Installing and running MagicDraw

Windows 95/98/NT/2000/XP/Vista* Instructions

After downloading, double-click MD_UML_<version>_win.exe.

Unix Instructions

After downloading, open a shell and go to the directory where you downloaded the installer.
At the prompt type: sh ./MD_UML_<version>_unix.sh.

Be sure you have JVM installed.

Mac OS X Instructions

Recommended Mac OS X v10.4 (Tiger) or Mac OS X v10.5 (Leopard)** and Java 1.5.
After downloading, double-click MD_UML_<version>_mac.dmg and install application by dropping all content to the Applications folder (or somewhere else).

We suggest creating additional folders for different MagicDraw versions in MAC OS X Applications folder in case do not overwrite old client with the new one. After installing MagicDraw to several folders you will be able to import the old MagicDraw version configuration.

To install MagicDraw to newly created folder:

  1. In the Applications folder create folder named as MagicDraw version. For example, MagicDraw 15.1.
  2. Drag MD_UML_<version number>_mac.dmg content to the Applications/MagicDraw 15.1.

All Other Platforms Instructions (no install version)

Download MD_UML_<version>_no_install.zip.
After downloading, extract the file.

NOTE: For Microsoft Windows 7 or Microsoft Windows Vista users. When you are applying the service pack or patch, set your archiver program to run as administrator. In order to do that, open the archivers executable file properties and, in the Compatibility tab, select the Run this program as an administrator check box.

Running MagicDraw

On Windows platform:
    Launch mduml.exe in bin directory to start MagicDraw.
On Unix or Mac OS X platform:
    Launch ./mduml in bin directory to start MagicDraw.
Be sure you have JVM installed.

* Vista is recommended for MagicDraw v12.1 and later.
** Mac OS X v10.5 (Leopard) is recommended for MagicDraw v15.0 and later.


Applying and running MagicDraw Patch

To apply patch manually:

  1. Download sp1_MD_UML_<version>.zip (for the Personal Edition sp1_MD_UML_<version>_PE.zip).
  2. Stop MagicDraw.
  3. Unzip downloaded file in the directory where MagicDraw is installed.

NOTE: For Microsoft Windows 7 or Microsoft Windows Vista users. When you are applying the service pack or patch, set your archiver program to run as administrator. In order to do that, open the archivers executable file properties and, in the Compatibility tab, select the Run this program as an administrator check box.

To apply patch manually for Mac OS X users:
Copy the sp1_MD_UML_<version>.zip (for the Personal Edition sp1_MD_UML_<version>_PE.zip) file to the MagicDraw installation folder. Then using command line go to the MagicDraw folder and unzip patch content.

Running MagicDraw

On Windows platform:
    Launch mduml.exe in bin directory to start MagicDraw.
On Unix or Mac OS X platform:
    Launch ./mduml in bin directory to start MagicDraw.


Recommendations

To use the MagicDraw's release that contains no Java Virtual Machine (JVM), you should have the JVM installed on your computer. JVM is an application that provides the interpretation of the bytecode Java class files. Different operating systems may have different JVM implementations, thus some bugs may be specific to the operating system or JVM.

MagicDraw is a stable environment, if it is configured properly and if the stable JVM is used. USE RECOMMENDED JVM TO AVOID A LOT OF PROBLEMS. All recommendations are written below. As MagicDraw is a Java application, most of the stability and performance depends on the JVM implementation. Refer to the JVM specification and problems' description, if you have problems on the specific OS.

JDK 1.1.x, 1.2.x, 1.3.x, and 1.4.x is not supported.

You can review your system and JVM information from Help->About MagicDraw->Info tab dialog (of course, if you have installed MagicDraw already). JDK version also can be encountered from command line by writing:
java -version

Attention non-Windows users!

You have to launch setup from the command line. Your system should have Java Virtual Machine (JVM) BEFORE the MagicDraw installation (preferred versions are mentioned above).

The newest MagicDraw demo version you can download at: http://www.nomagic.com


MagicDraw start-up configuration

To change Java version

Change line in file mduml.properties (this file is in <MagicDraw installation directory>/bin/ folder):
JAVA_HOME = <path to new JDK>

NOTE: Integrated MagicDraw runs on the JVM specified by the IDE. In order to change JVM, you need to modify start-up properties for the IDE, MagicDraw integrates with. If you are running MagicDraw integrated with IDE, read the appropriate readme.html for specific integration, which can be found in <MagicDraw installation directory>/integrations/<IDE directory>.

MagicDraw configuration files location

By default MagicDraw configuration and auxiliary files are stored in the user home directory - <User home directory>/.magicdraw/<version>.
You may also save configuration files:

  1. In the MagicDraw installation directory.
  2. In your chosen directory.

You may check the exact path to configuration files in the MagicDraw About screen, Environment tab, Configuration files line (invoke the About screen from the Help main menu, About MagicDrawcommand).

To store MagicDraw configuration files in MagicDraw installation directory
Add argument into JAVA_ARGS line in file mduml.properties (this file is in <MagicDraw installation directory>/bin):
JAVA_ARGS=-DLOCALCONFIG=false

To store MagicDraw configuration files to your chosen location
You may define custom path for configuration files in two ways:

  • In the mduml.properties file, JAVA_ARGS line add the property -Dlocalconfig.location=<custom path>
  • Define custom path in a newly created file:
    1. In the <User home directory>/.magicdraw/folder, create file named magicdrawredirect.
    2. In the created file, type absolute path where MagicDraw configuration and auxiliary files will be saved, for example: C:\<directory name>.

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

Redirect output to console instead of log file
By default all MagicDraw output info goes into md.log file. Output can be redirected to console instead of log file.

All platforms
Pass application argument (not java property) -verbose.
Add argument into JAVA_ARGS line in file mduml.properties (this file is in <MagicDraw installation directory>/bin/ folder):
APP_ARGS =-verbose


MagicDraw troubleshooting

OutOfMemory problem

Sometimes when running the program the Out Of Memory error occurs.

Windows, Linux OS, Mac OS X

If during your work the out of memory Error dialog box appears, change the java heap size and the MaxPermSize directly in this dialog box.

In the Xmx field change the number of heap size '600' to bigger heap size in megabytes. In the XX:MaxPermSize field you can increase the MaxPermSize.

You can also change the java heap size or MaxPermSize In your mduml.properties file, in the line:

JAVA_ARGS=-Xmx600M -XX\:MaxPermSize\=150M.

NOTE: Integrated MagicDraw runs on the JVM, specified by the IDE. If you are running MagicDraw, integrated with IDE, you will need to modify startup properties for the appropriate IDE.

StackOverflow problem

Sometimes when running the program, the StackOverflowError occurs.
Windows, Linux OS, Mac OS X
If you are running the Sun's, IBM JVM, set the following java properties in your mduml.properties file to avoid the above problem:
to the line JAVA_ARGS=-Xmx600M, append the string -Xss<stack size>.

For example:
JAVA_ARGS=-Xmx600M -Xss2M
This sets java stack size to 2 megabytes.

NOTE: Integrated MagicDraw runs on the JVM, specified by the IDE. If you are running MagicDraw, integrated with IDE, you will need to modify startup properties for the appropriate IDE.

Computer freezes or reboots while exiting MagicDraw or repaint problems occur

This may happen because of Java SDK and Windows direct draw incompatibility. We would suggest you to turn off the direct draw for MagicDraw application. In the <MagicDraw installation directory>/bin/mduml.properties file to the line'JAVA_ARGS=' append additional part -Dsun.java2d.noddraw.

NOTE: Integrated MagicDraw runs on the JVM, specified by the IDE. If you are running MagicDraw, integrated with IDE, you will need to modify startup properties for the appropriate IDE.

After the install, MagicDraw cannot be launched or it just appears on the screen and vanishes

Please try one of the following solutions:

  • Start MagicDraw with system property no.printer.lookup=true.
    In the <MagicDraw installation directory>/bin/mduml.properties file to the line'JAVA_ARGS=' append additional part -Dno.printer.lookup=true.
  • The problem may be related with printer driver. The description of this problem is published in the Java Bug Database (http://java.sun.com/). Bug ID is 4988827. Try to change the default printer driver on your Windows OS and load again. For example, the HP LaserJet 4000N PCL5e should be compatible, while HP LaserJet Series 4000 PCL6, HP LaserJet Series 4000 Postscript, Savin 2535 PCL6, HP LaserJet Series 5000 Postscript, HP Deskjet 560C, Acrobat PDFWriter are not.
  • The problem may be related with Java SDK 1.4.x (this java version is not supported). Try to use Java SDK 1.6.0_10.

NOTE: Integrated MagicDraw runs on the JVM, specified by the IDE. If you are running MagicDraw, integrated with IDE, you will need to modify startup properties for the appropriate IDE.

MagicDraw is not started on Windows Vista

If you are using the recommended java version and MagicDraw can be started only under Administrator privileges, the possible reason can be the Windows Vista User Access Control (UAC) restrictions. You can try to turn off the UAC and then to start MagicDraw.

For more information about turning off the UAC, see the Microsoft Windows website: http://windowshelp.microsoft.com/Windows/en-US/Help/58b3b879-924d-4e08-9358-c316055d3eae1033.mspx.

MagicDraw is not started on Mac OS X Mountain Lion

If MagicDraw cannot be started on Mac OS X Mountain Lion, it can be that you need to exempt MagicDraw from Gatekeeper. To do this, in the System Preferences > Security & Privacy dialog, select the Anywhere option.

For more information about Gatekeeper on Mac OS X Mountain Lion, see http://support.apple.com/kb/HT5290

Buttons in MagicDraw application are inactive

This problem is related to the native non-English computers locale and will be fixed in future versions. For the moment we would suggest the following solution:

  1. Go to the resources folder in the MagicDraw installation directory and cut all files from it.
  2. Create the new folder (the name of this folder is not important) in the same MagicDraw installation directory and paste those cut files in it.
  3. Open MagicDraw. Everything should work fine, although you will be able to select only English language for MagicDraw interface. If you would like to choose any other language, copy and paste those resources files back to resources directory and restart MagicDraw.

Screen menu items are inactive on Mac OS

This problem is related with screen menu. To disable screen menu, follow the steps:

  1. Open Info.plist file located in /Applications/MagicDrawUML.app/Contents using "Property List Editor" application (from "XCode Developer Tools").
  2. Expand the Root->Java->Properties node.
  3. Change the apple.laf.useScreenMenuBar java property's value from 'true' to 'false'.
  4. Save the file and reopen MagicDraw application.

NOTE: Integrated MagicDraw runs on the JVM, specified by the IDE. If you are running MagicDraw, integrated with IDE, you will need to modify startup properties for the appropriate IDE.

MagicDraw installer is not started or MagicDraw is not started on Linux OS

MagicDraw installer may not be started or MagicDraw itself may not be started, because of changes in default system Java. In this case when starting installer or MagicDraw, no GUI appears or when starting from command line the following message is displayed:
Configuring the installer for this system's environment... No Java virtual machine could be found from your PATH environment variable. You must install a VM prior to running this program.
We would suggest the following solution:

  • Change your default system Java to recommended. Recommended Java Virtual Machine is Sun's JDK 1.6.0_10 for Linux.
  • After some Ubuntu update, the Ubuntu Java overrides default Sun Java and default system Java becomes Ubuntu Java. To start the MagicDraw installer, Ubuntu-restricted-extras should be installed. For more information about installing the Ubuntu-restricted-extras, see the Ubuntu website: https://help.ubuntu.com/community/RestrictedFormats.

Diagram printing is not working on Linux OS

The problem is related with the Linux cups package update.
This problem is Sun Java bug and description of this problem is published in the Java Bug Database: http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6633656.
To solve diagram printing problem we would suggest to use 1.6.0_10 JVM or later, because this issue is solved in these java versions.
If you can not use the 1.6.0_10 JVM or later, other possible solution would be the following:

  1. Open the file /etc/cups/printers.conf
  2. Before each line with the text </Printer>, add the following line:
    Options orientation-requested 3

For more information about solving this problem, see the Ubuntu bug database: https://bugs.launchpad.net/ubuntu/+source/sun-java6/+bug/156191/comments/18.

You can also use the workaround for diagram printing and print the diagram in the following way:

  1. Export diagram as Image. To do this from the File menu choose Save as Image.
  2. Open exported image and print it.

For more information about saving diagram as images see MagicDraw UserManual.pdf, Working with Diagrams > Saving as Image section.

Links

Frequently Asked Questions

If you cannot find the answer to your problem in the list above, please visit our website for FAQ in http://www.nomagic.com/support/faq.html

System Requirements
http://www.nomagic.com/support/system-requirements.html

Java Virtual Machine list
http://www.nomagic.com/support/jvm-list.html

Download Documentation
http://www.nomagic.com/support/documentation.html

Online demo
http://www.nomagic.com/support/demos.html

Example files

After you have installed the MagicDraw, you can open an example of a diagram. These files are in the MagicDraw installation directory, "samples" subdirectory.

no magic uml conference 225x108


omg-member-logo

nomagic gartner-ad 2013

facebook 32 linkedin 32 twitter 32 youtube 32 rss 32