Page tree

MagicDraw 19.0 LTR SP3 Documentation

As of MagicDraw version 17.0.1, the project file inner structure has been changed. Now the latest project file has additional auxiliary information about a project structure. After MagicDraw Teamwork Server has been upgraded to version 17.0.1, you should upgrade your projects used in earlier server versions to the latest file format. After that, you will have full project management features available. To migrate a project to the latest format, projects and used modules must be re-saved (re-committed) in the server.

For project migration, you can use the automatic server project migration feature or migrate each server project manually.

While the project is upgrading, other users are prevented from any modifications in that project. It is highly recommended to migrate all projects by the same person.

You can migrate server projects to 17.0.5 or later version without upgrading the server.

Starting with version 17.0.4, upgrading Teamwork Server is not required to access server projects with the upgraded version of the client application.

For the instructions how to enable connections to the server from later client versions, see Activating Teamwork Server license after purchase at

Automatic server project migration

The automatic server project migration feature allows for migrating all server projects at one time.

You must have the Administer project permission for migrating projects. For more information about the permissions, see “User permissions” in MagicDraw Teamwork UserGuide.pdf.

To migrate all server projects automatically

  1. From the Collaborate menu, select Migrate Project to Version 17.0.1.
  2. The question message appears.
  3. Do one of the following:
    • Click Yes to migrate all server projects.
    • Click No to cancel this action.

After the project migration is completed, you will get a message informing about successful project migration or containing the list of projects that were not migrated. You need to migrate those projects manually.

Example of message appearing after migrating server projects

Manual server project migration

To migrate server projects manually

You must have the Administer project permission for migrating projects. For more information about the permissions, see User permissions.

  1. Open a server project in Teamwork Server. The message notifying that project has been upgraded and requires to be committed to a server of a new version appears. See the following example of the message.
  2. Click OK and commit the project to the server.

For more information about committing a project, see section Committing to Teamwork Server. Perform these actions for all projects and modules you want to migrate to Teamwork Server version 17.0.1 or later.


In particular cases, server projects are not upgraded to latest file format. It may happen in the following cases:

  • When the entire project or some modules are not committed to the server.
  • When the project structure remains locked after the project has been committed to the server.

In these cases, you get the following message while loading the project:

You are not allowed to make any modifications in such opened project as projects are opened in the read-only mode.

To solve this problem, the following actions should be performed:

  1. Close the project.
  2. If any user is currently upgrading the project, he or she should commit this project to the server after the project has been upgraded.
    After the project has been committed, the user should check if the project structure is unlocked. If the project structure is locked, the user who locked the project or an administrator should unlock the project manually in the Project Properties dialog.
    For more information about project structure locking, see section Locking project structure.

    View of Project Properties dialog when project structure is unlocked
  3. Open the project. If the project was upgraded and committed properly, the project structure is unlocked, and project is available for modifications.

Related procedures:

Locking Project

Committing to Teamwork Server

Related references:

Commit Project to the Server dialog

Working with Project Properties dialog

  • No labels