Version Upgrade

Upgrading client, floating license server, and Teamwork Server to a later version or service pack

Clients are programs that connect to a server. No Magic Inc. provides MagicDraw, Cameo Enterprise Architecture, and Cameo Business Modeler as clients that can be used to work simultaneously in the collaborative environment.

IMPORTANT! Commercial licenses (clients, plugins, and Teamwork Server) for version 16.9 or later are node locked to a particular machine. After upgrading a program to version 16.9 or later, you will be requested to activate the license and, upon successful activation, will receive a commercial license dedicated to that particular machine. If you have already activated the license and have used an automatic update to upgrade a program to a new version, the license will be activated automatically.

 

Automatic Upgrade

The best way to upgrade is to use the automatic update feature that has been available since MagicDraw version 7.5 (and from the initial version for other clients), as well as in the Teamwork Server.

The automatic update searches out and offers the latest program versions and service packs.

When the upgrade to the new version starts, it will offer to download the latest supported Java VM, if your application uses an earlier one. Before the downloaded archive is extracted, the program will be shut down. All configuration files of the earlier version will be saved in the <program installation directory>\$$$BACKUP$$$ folder. The new version of the application will start after the automatic update is finished.

NOTE: You will only be able to upgrade commercial MagicDraw editions and get service packs if you have valid Software Assurance.

IMPORTANT! The client and the Teamwork Server must always be of the same version number. For example, you are not allowed to use a server version 16.9 with a client version 17.0.

Upgrading A Client

To upgrade a client, from the Help menu choose Check for Updates. If needed, specify any HTTP Proxy Server connection parameters and download the latest client version or service pack.

When the automatic update is finished and the program is restarting, the Import Configuration dialog opens. This dialog allows the import of the Environment Options from the previous version.


NOTES:

  • If you are using a client with Teamwork Server, you must disconnect from the Teamwork Server before upgrading the client.
  • If you are using a client integrated with any IDE, please reintegrate the client with this IDE after upgrading.
  • Client programs are not forward compatible. Therefore, it is not possible to open project files with an earlier program version (for example, version 16. 9) after projects are saved with the later program version (for example, version 17.0).
  • Before upgrading clients with floating keys, do not forget to apply a new key to the Floating license server (for versions earlier than 16.8) or FlexNet license server (for version 16.8 and later).
  • If all new licenses in the license owner account at www.magicdraw.com are already activated, an automatic activation after the upgrade to a new version will not be possible. You will receive a temporary 7-day license after the upgrade. You will then need to do one of the following:

If problems still persist, please contact your administrator, register the issue at http://support.nomagic.com, or contact your account executive by emailing This email address is being protected from spambots. You need JavaScript enabled to view it. .

Upgrading FlexNet License Server

As of version 16.8, FlexNet license server is used to manage Floating Licenses. For FlexNet license server installation instructions, please visit the Installing and Running page.

For upgrading lmadmin, please refer to section "Upgrading lmadmin" in the License Administration Guide.

NOTES:

  • The FlexNet license server is compatible with clients of version 16.8 and later. In order to use floating licenses with client versions, for example, 16.6 and 16.8 simultaneously, both Floating Server and FlexNet license server installations are needed.
  • The FlexNet license server runs on the following operating systems:
    • AIX® 32bit / 64bit
    • HP-UX® 32bit / 64bit
    • Linux 32bit / 64bit (Linux Standard Base (LSB) 3.0)
    • Mac®OS 32-bit / 64-bit (Mac OS X 10.4, 10.5 and 10.6)
    • Red Hat® Linux 64-bit
    • SGI 64-bit
    • Windows Server 2003, 2008 32bit and 64bit
    • Windows Vista (Ultimate), Windows 7 (Ultimate) 32bit and 64bit
    • IMPORTANT! Sun OS/Solaris is not supported by the MagicDraw Cameo daemon.
  • An automatic update for licenses is not available.

Upgrading Floating License Server

To upgrade the Floating License Server version 16.6 and earlier:

  1. Make sure that all online and offline sessions are finished.
  2. Stop the Floating License Server.
  3. Remove the NT service from the Floating License Server, if it was added) and close the Administrator's Console. Skip this step for other operating systems.
  4. Start the Floating License Server GUI version (use the run_server.exe file from the <Floating License Server installation directory>\bin folder).
  5. Click the Check for Updates button in the opened Floating License Server dialog.

NOTE: All configuration files from the earlier version of the Floating License Server are imported automatically.

IMPORTANT! As of version 12.0, Floating License Server can host licenses for different versions of the client. For example, you are allowed to use a license server version 12.0 with a client version 12.5 or later.

Upgrading Teamwork Server

NOTE: We recommend making a backup of the project folder before upgrading Teamwork Server.

To upgrade Teamwork Server:

    1. Stop the Teamwork Server and close the Administrator's Console.
    2. Deactivate the current license for the Teamwork Server. Note: The online activation is not available for the Teamwork Server. Please deactivate it manually in the License Activation Management screen.
    3. For the Windows operating system, remove the Teamwork Server NT service, if it was added. Skip this step for other operating systems.
    4. Start the Teamwork Server GUI version (use the teamwork_server.exe file from the <Teamwork Server installation directory>\bin folder).
    5. When the dialog opens, click the Check for Updates button to check and download program upgrades and updates. NOTE: If the HTTP Proxy Server Connection dialog opens, click Use HTTP proxy server if you want to use a proxy server. Enter required values and click OK when you are done. Checking for updates starts.
    6. When the automatic update finishes, the Import Configuration dialog opens. In this dialog, click the Import button to import all teamwork projects and users from the previous Teamwork Server version.

 

 

After upgrading the server to version 16.9 or later, you will be requested to apply the commercial license dedicated for the particular machine. Please visit Commercial license activation for instructions on how to get the Teamwork Server license.

IMPORTANT! Teamwork Server and its client must be of the same version. Otherwise, the clients will not be able to connect to the server.

MagicDraw Teamwork Server versions earlier than 10.0 do not have the automatic upgrade feature.

 

Manual Upgrade

If an automatic update feature does not work, please register the issue at http://support.nomagic.com and try to upgrade a client manually.

IMPORTANT! The client and Teamwork Server must always be of the same version number. For example, you are not allowed to use a server version 12.5 with a client version 14.0.

Upgrading a Client

    1. Deactivate the current license.
    2. Close the client.
    3. Download and install the new client version. Start it after the installation is finished.
    4. The Import Configuration dialog will appear upon opening the new program version for the first time.
    5. In the dialog, type the path to the installation folder of an earlier version to import program configurations from it.

 

 

After upgrading the client to version 16.9 or later, you will be requested to activate the license and receive the commercial license dedicated for the particular machine.

NOTES:

  • To see installation instructions of a particular service pack, click the corresponding link in the list of service packs.
  • If you are using a client integrated with any IDE, please reintegrate the client with this IDE after upgrading.
  • It is not recommended to open project files with an earlier program version (for example, version 10.0) after projects are saved with the later program version (for example, version 10.5). Client programs are not forward compatible.
  • Before upgrading any client with a floating license, do not forget to apply a new key to the Floating license server.

Upgrading FlexNet License Server

As of version 16.8, the FlexNet license server is used to manage Floating Licenses. For detailed FlexNet license server installation instructions, please visit Installing and Running.

For instructions on how to upgrade lmadmin, please refer to section "Upgrading lmadmin" in the License Administration Guide.

NOTES:

  • The FlexNet license server is compatible with clients of version 16.8 and later. In order to use floating licenses with client versions, for example, 16.6 and 16.8 simultaneously, both Floating Server and FlexNet license server installations are needed.
  • The FlexNet license server runs on the following operating systems:
    • AIX® 32bit / 64bit
    • HP-UX® 32bit / 64bit
    • Linux 32bit / 64bit (Linux Standard Base (LSB) 3.0)
    • Mac®OS 32-bit / 64-bit (Mac OS X 10.4, 10.5 and 10.6)
    • Red Hat® Linux 64-bit
    • SGI 64-bit
    • Windows Server 2003, 2008 32bit and 64bit
    • Windows Vista (Ultimate), Windows 7 (Ultimate) 32bit and 64bit
    • IMPORTANT! Sun OS/Solaris is not supported by the No Magic Cameo daemon.
  • An automatic upgrade for licenses is not available.

Upgrading Floating License

When you need to upgrade to a later version MagicDraw or any other product from the Cameo products family which uses a floating license, you should begin with upgrading the floating license so that it supported the particular version.

There are two steps in the license upgrade procedure:

1. Getting a new license file
2. Adding the new license file to the floating license server

1. Getting a new license file

To get a new license file:

  1. Sign in the license owner account at www.nomagic.com.
  2. Click License List in the Members area that is on the right side of the website. The webpage with a list of licenses purchased by you or your company will open (see the following figure).
  3. Below the Floating products license list, click
    • The Send key button, if you wish the license file was sent to your email system.
    • The Download key button, if you wish to download the license file directly to your personal computer.

All the licenses from the Floating products license list will be included in one single license file.

IMPORTANT! If you use more than one floating license server, you need to get a license file for each server.

2. Adding the new license file to the floating license server

To add the new license to the floating license server, use the license server manager that can be either:

  • lmadmin (recommended)
  • lmgrd

To add a new license file to the floating license server using lmadmin:

  1. Open the Web browser and go to the license server management interface at http://<server>:8090, where <server> is the system name where the license server is running.
  2. Sign in as the administrator.
  3. On the left side menu, click Vendor Daemon Configuration.
  4. Click Import License.
  5. Click Browse and specify the location of the new license file.

    Click to select the Overwrite License File on License Server checkbox and then click the Import License button.

    If the license file is successfully imported, you will see an appropriate message on the webpage.
  6. Restart the cameo vendor daemon. Do the following:
      6.1. In the appropriate cameo vendor daemon row, click the Administer button.
      6.2. Click Stop under Vendor Daemon Actions.
      6.3. Click Start under Vendor Daemon Actions.
  7. Check if the licenses were successfully updated. For this, do the following:
      7.1. Switch to the Dashboard mode.
      7.2. Click Concurrent.

If the licenses were successfully updated, you will see them listed as is shown in the following figure.

Be advised that there is an alternative way of adding a new license file to the floating license sever. You can copy the new license file directly to a specific location in the floating license server installation folder rather than importing the file by using lmadmin.

To add a new license file to the floating license server by copying it directly to a specific location:

      1. Go to the folder wherein the new license file is stored and copy the file.
      2. Go to <floating license server installation directory>\licenses\cameo and paste the file.
      3. Open the Web browser and go to the license server management interface at http://<server>:8090, where <server> is the system name where the license server is running.
      4. Sign in as the administrator.
      5. On the left side menu, click Vendor Daemon Configuration.
      6. In the appropriate cameo vendor daemon row, click the Administer button.
      7. Click the Reread License Files button.

        If the license file is successfully imported, you will see an appropriate message on the webpage.
      8. Check if the licenses were successfully updated. For this, do the following:
          8.1. Switch to the Dashboard mode.
          8.2. Click Concurrent.

If the licenses were successfully updated, you will see them listed as is shown in the following figure.

For the alternative ways of adding a new license file by using lmgrd, see the License Administration Guide that can be found at http://www.globes.com/support/fnp_utilities_download.htm#docs.

Upgrading Floating License Server

To upgrade the Floating License Server version 16.6 and earlier:

      1. Make sure that all online and offline sessions are finished.
      2. Stop the Floating License Server.
      3. Remove the NT service from the Floating License Server, if it was added and close the Administrator's Console.
      4. Install a new version of the Floating License Server to the new directory and run it. Add the NT service, if it is needed.
      5. Uninstall the earlier Floating License Server from the previous location.

IMPORTANT! As of version 12.0, different versions of Floating License Server and a client can be used.

Upgrading Teamwork Server

NOTE: We recommend making a backup of the project folder before upgrading the Teamwork Server.

To upgrade the Teamwork Server:

        1. Stop the Teamwork Server.
        2. Deactivate the current license for the Teamwork Server. Note: The online activation is not available for the Teamwork Server. Please deactivate it manually in the License Activation Management screen.
        3. For the Windows operating system, remove the Teamwork Server NT service, if it was added. Skip this step for other operating systems.
        4. Install a new version of the Teamwork Server to the new directory and start the server.
        5. The Import Configuration" dialog appears while starting the Teamwork Server. In the dialog, type the path to the installation folder of an earlier version to import program configurations from it.

 

 

      1. In order to import teamwork projects and users from the earlier Teamwork Server version, select the Import all projects and users check box.
      2. Start the newly installed Teamwork Server and add the NT service, if it is needed.
      3. Uninstall the previous Teamwork Server version.
      4. After upgrading the server to version 16.9 or later, you will be requested to apply the commercial license dedicated to the particular machine. Please visit the Commercial license activation for instructions on how to receive the Teamwork Server license.

NOTES:

      • The installation of a later server version does not detect nor uninstall an earlier server version. We also recommend using the same JVM version for the server and client.
      • To see installation instructions of a particular service pack, click the corresponding link in the list of service packs.

IMPORTANT! Teamwork Server and its clients must be of the same version. Otherwise, the clients will not be able to connect to the server.

no magic uml conference 225x108


omg-member-logo

nomagic gartner-ad 2013

facebook 32 linkedin 32 twitter 32 youtube 32 rss 32