Upgrading Projects

You can upgrade projects from previous Design Studio versions to the latest Design Studio version. When you first open Design Studio, the application verifies whether any open projects require upgrade.

When upgrading projects that are dependent on other projects, you must upgrade the dependent projects first. During the upgrade process, all dependent projects must exist in the workspace to ensure that the upgrade process can convert all projects in the correct order.

Important:

Before upgrading projects, back up all Design Studio Modeling Basics projects and ensure that all of the content in your projects is writable.

When the upgrade process completes, Design Studio saves the information about the upgrade process in the project-dir/upgradeLog/upgrade.log file.

All information about the upgrade process, including notifications about failed upgrades, is included in this file.

Note:

Prior to upgrading older project versions, you must define all project references. See "Defining Project Dependencies using Project Properties" for more information.

Upgraded projects are not compatible with previous Design Studio versions. Ensure that you upgrade copies of projects or use source control.

To upgrade a project:

Do one of the following:
- Import a project created in an older version of Design Studio into the latest version of Design Studio. See "Importing Projects" for more information.
- Open a workspace that contains projects created in an older version of Design Studio. See "Switching Workspaces" for more information.
If an open project requires an upgrade, the Upgrade Project wizard appears, listing all projects and dependent projects that require an upgrade.
Confirm that the projects are in the correct order.

If the projects are not upgraded in the proper order, the upgrade process can fail and leave the project in an unknown state. Design Studio determines the correct order in which to upgrade the projects based on the dependencies defined for the project (the lowest project in the dependency hierarchy is upgraded first). If you have not properly defined the project dependencies, you must manually set up the proper order.

If the projects are not in the correct order, do one of the following:
- Select a project and click Move Up or Move Down to change the order of the projects.
- Cancel the upgrade process, return to your previous version of Design Studio, and define the project dependencies.
  
  See "Defining Project Dependencies using Project Properties" for information about how to define project references.
Click Finish.

The upgrade process completes and the Display Upgrade Log dialog box appears.
Do one of the following:
- Click Yes to review the generated upgrade log file.
- Click No to complete the upgrade process without reviewing the generated log file. You can view the update logs at a later time.

Note:

If you cancel the project upgrade before the upgrade process completes (by clicking the Upgrade Project wizard Cancel button) the project remains open in the workspace. You must close and reopen the project to attempt the upgrade again before working in the project. Do not perform any work in a project that has failed to successfully complete the upgrade process. See "Closing Projects" and "Opening Projects" for more information.

Note:

When upgrading Design Studio for Inventory cartridge projects that include changes to tool tips or characteristic display names, you must redeploy the UIM application server when you deploy the cartridge that contains the changes.