no magic inc uml logo

Software Upgrade for Enterprise

There are five things to upgrade when migrating to later version (not service pack):

  1. Floating server software
    Flexera software (optional upgrade, only license upgrade to version 18.0 is necessary)
  2. Client software
    MagicDraw or MagicDraw based product, for example, Cameo Systems Modeler (mandatory upgrade)
  3. Plugins
    Such as SysML Plugin and others (mandatory upgrade)
  4. Server software
    Teamwork Server (upgrade is recommended for the full performance of new features)
  5. Repository data
    Teamwork Server projects (mandatory upgrade)

Things to consider before starting software upgrade:

  • Partial migration
    Starting from version 17.0.4, Teamwork Server supports multiple project versions. Different teams can work with the same Teamwork Server with different project versions, e.g. 17.0.5 and 18.1. So with Teamwork Server migration, only part of the projects could be migrated into the newest version. However within a project, the same version client application must be used.
    Floating server allows connecting all older versions clients starting from version 16.9.
  • Downtime
    Please dedicate at least one day downtime for products and data migration.
  • Custom artifacts (i.e. plugins, report templates) upgrade
    After migration, custom artifacts could be incompatible. Please check compatibility in advance. Note: we can help to test compatibility, and also upgrade custom artifacts.
  • Recommended upgrade workflow
    Upgrade: Teamwork Server, floating server license, client applications, plugins, required project on Teamwork Server. Before production environment migration we suggest to check Teamwork Server project upgrade and custom artifacts compatibility on test environment.
  • System requirements
    Check that new hardware and software conforms to the system requirements.

Before starting with upgrade procedure, sign in to your account at and download the installation files.


Upgrade your floating license. See detailed instructions.


Upgrade your MagicDraw or MagicDraw based product client software. See section 5 "Updating MagicDraw" in our detailed instructions.


Upgrade your plugins, for example, SysML plugin. Check compatibility tables to find compatible versions of the plugins you need to upgrade. See detailed plugin upgrade instructions. If you're using your own or third-party developed plugins, contact their developers/owners for new versions and update instructions.



To begin the update of Teamwork Server, you must:

  1. Commit all projects and stop the server.
  2. Back up your Teamwork Server projects directory. Default directory locations (starting from version 17.0.4):
    • Windows 7/8
      C:\ProgramData\.magicdrawserver\<version number>\
    • Windows 2000/XP
      C:\Documents and Settings\All Users\ApplicationData\.magicdrawserver\<version number>\
    • Windows NT4
      C:\WINNT\Profiles\All Users\ApplicationData\.magicdrawserver\<version number>\
    • Other OS
  3. Default projects directory location (versions prior to 17.0.4):
    • Any OS
      <Teamwork Server installation directory>\projects

Installation of New Teamwork Server version

Install a new version of Teamwork Server into a separate location. See detailed instructions.

Then unlock and activate Teamwork Server. See detailed instructions.

Teamwork Server Project Migration

  1. When your Teamwork Server is activated stop the server, then replace the projects directory with the backup directory you created. Default projects directory locations (starting from version 17.0.4):
    • Windows 7/8
    • Windows 2000/XP
      C:\Documents and Settings\All Users\ApplicationData\.magicdrawserver\
    • Windows NT4
      C:\WINNT\Profiles\All Users\ApplicationData\.magicdrawserver\
    • Other OS
  2. Default projects directory location (versions prior to 17.0.4):
    • Any OS
      <Teamwork Server installation directory>\projects
  3. To finish migrating server projects, start MagicDraw, then log in to Teamwork Server as administrator.
  4. From the main menu, select Collaborate > Migrate Project to Version <new version>.

If you prefer to migrate your server projects by modifying the server properties file or by changing the repository location in Teamwork Server Administrator's Console, follow these steps.

For more information about migrating server projects, see section "Migrating server projects to MagicDraw Teamwork Server 17.0.1 or later" in MagicDraw User Manual.

After migrating projects, you can check their version: on the main menu, click Collaborate > Open Server Project, select a project, then click the Project Info button info button and click Meta information in the dialog that opens.

Your upgrade is now finished!

If you have additional questions or concerns, please feel free to contact us.

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