This topic describes several considerations for upgrading to version 3.
There are two primary upgrade scenarios.
The first scenario assumes that you are upgrading Rational® Quality Manager and the Jazz™ Team Server at the same time. This scenario assumes that although you may have configured integration with the other CLM products in version 2, your primary interest is to upgrade Rational Quality Manager to version 3.
The second scenario assumes that you have already upgraded to Jazz Team Server version 3.0.1 for one of several reasons:
Integration with Rational Quality Manager version 3 requires Rational ClearQuest® version 7.1.2 or higher. If you configured Rational Quality Manager version 2 to use Rational ClearQuest as your defect provider, you must first upgrade Rational ClearQuest to version 7.1.2.
In addition, if you previously integrated with an earlier version of the Rational ClearQuest bridge, you must use the repotools -migrateCmLinks command to migrate your existing links to work with Rational Quality Manager version 3. For details, see -migrateCmLinks.
If you are using the IBM® Rational ClearQuest Synchronizer, you must be sure to also install the Change and Configuration Management (CCM) application that is included with your version 3 installation
For further details about integrating with Rational ClearQuest, see Rational Quality Manager and Rational ClearQuest.
If you previously configured Rational Team Concert version 2 as your defect provider, you can continue to use version 2 or you can upgrade to the Change and Configuration Management (CCM) application of Rational Team Concert version 3.
In addition, the Task-Quality work items that were previously managed internally within Rational Quality Manager, are now managed in the CCM application. For details about the use of work items and defects in version 3, see Managing the team with work items.
In Rational Quality Manager version 2, you could manage requirements locally within the tool itself or in an external requirements provider. In version 3, your options are as follows:
If you used Rational Common Reporting in version 2, you must migrate the reports to Rational Reporting for Development Intelligence. To migrate from Rational Common Reporting 1.0.x to Rational Reporting for Development Intelligence 1.0.2, you must export the custom reports, uninstall Rational Common Reporting, install Rational Reporting for Development Intelligence, and import the data into the new Rational Reporting for Development Intelligence installation. For details, see Migrating Rational Common Reporting to Rational Reporting for Development Intelligence and also Migrating report data from version 2.
Project area read-access permission in version 3 is handled differently than it was in version 2. Any version 2 project areas with a read-access policy set to Everyone will be exposed as a Public Project Area in version 3.
In version 3, project administrators must explicitly set the read access for the migrated project area. Any newly created project areas in version 3 will be set to protected by default. To change the access permission for the project area:
If you grant access to members of the project area hierarchy, anyone who adds a member to any team will implicitly grant access to the entire project. For strict control, grant access to users in the access list only. Repository administrators will always have access. If this project area shares its process, anyone who can read a project area that uses the process will be able to read this project area, regardless of the setting on the Access Control page.
There have been additional permissions added to the roles in version 3. Where appropriate, the permissions have been given a default value. However, permissions for some of the new version 3 features aren't set by default. It is recommended that you review the permissions of your migrated project area roles and see if adjustments should be made for some of the version 3 features.
For a list of the minimum version requirements for the test tool adapters in version 3, see Test tool adapters.