Applying package upgrades

When changes occur in Rational® ClearQuest® or the integrated packages, you may need to upgrade your existing integrations.
Note: If you are upgrading an integration with Rational ClearQuest, see "Upgrading Rational ClearQuest" in the IBM Rational ClearQuest and ClearQuest MultiSite Installation and Upgrade Guide

To upgrade all your existing packages:

  1. Log in to Rational ClearQuest Designer with Super User or Schema Designer privileges.
  2. If the Open Schema window is displayed, click Cancel.
  3. In Rational ClearQuest Designer, click Package > Upgrade Installed Packages.
  4. Select the schema name from the list of schema repositories and click Next.
  5. A list of all the packages that need to be applied appears. To continue, click Upgrade.
  6. After the upgrade is complete, click Exit.

    If you are upgrading a UCM integration from release 2000.02.10, make sure to map the UCM state types before you move to the next step. To map the UCM state types:

    1. In Rational ClearQuest Designer, click Package > Setup State Types.
    2. In the Package Wizard, click AMStateTypes from the list of Packages and accept the default value for the Record Type.
    3. Map each of the Rational ClearQuest states (shown in the right column) to the appropriate State Type from the pull-down menus in the State Type or left column.
    4. If you have UCM integrations with additional record types, they will be listed in the Record Type scroll-down menu. Select the next record type and repeat the mapping process for each of the record types.
      Note: For more information on mapping state types, see Customizing state models with the State Transition Matrix.
  7. Verify your work by clicking File > Test Work from the Rational ClearQuest Designer menu. Select the test database associated with the chosen schema and click OK to continue. For more information on testing schema changes, see Creating a test database.
  8. After the testing is complete and you verify that there are no errors, click Next.
    Note: If the upgrade fails, the errors are displayed in the status window.
  9. Check in your changes by clicking File > Check in and click OK.

Viewing the package upgrade status

The package upgrade displays the status as it completes the process. A typical status looks similar to the following example.

The following packages will be upgraded for DefectTracking:

 Email 1.0 will be upgraded to revision 6.0.

 
 Notes 1.0 will be upgraded to revision 3.0.

 
 Customer 1.0 will be upgraded to revision 2.0.

 
 UnifiedChangeManagement 3.0 will be upgraded to revision 4.0.

 
 Package upgrade was successful. Please click on Exit to close the 

 wizard. The schema will be opened for you to view the changes.

 
Related concepts
Overview of Rational ClearQuest integration packages
Rational ClearQuest integration packages
Related information
Overview of packages and integrations
Rational ClearQuest packages

Feedback