Upgrading to Rational Team Concert 5.0.2

If you plan to upgrade to 5.0.2, be aware of the following issues:

• Upgrading to version 5.0.2 is supported for versions 4.0 and later.
• The version of Apache Tomcat that is bundled with this release of the CLM products does not support NIST SP 800-131 strict mode. If you require strict mode and must upgrade, use IBM WebSphere Application Server.
• If the CLM applications to upgrade are co-located in the same WebSphere Application Server profile or on Apache Tomcat, you must upgrade all the applications at the same time.
• If you use CLM version 4.0 or later with DB2 9.7 or SQL Server 2008, you must upgrade to DB2 10 or SQL Server 2012 before you upgrade to CLM 5.0.2. For more information, see Work item 307924.
• After the CLM Server Monitoring Agent is deployed, you might encounter a message stating that the server is off-line or unreachable. If you did not encounter any issues during the setup, this message is incorrect. For more information, see the workaround about how to remove this message in Work item 334725.

If you use the optional program Rational Reporting for Development Intelligence to customize reports, you must upgrade to the 5.0.2 version of Rational Reporting for Development Intelligence after you upgrade Jazz Team Server and the data warehouse to 5.0.2. For more information about Rational Reporting for Development Intelligence, see the related section in Reporting and the upgrade process.

Rational Insight 1.1.1.5 is compatible with the CLM 5.0.2 release. You must first upgrade Jazz Team Server to version 5.0.2 before you upgrade Rational Insight. See the related section in Reporting and the upgrade process.

If you are upgrading any of the Change and Configuration Management (CCM), Quality Management (QM), and Requirements Management (RM) applications from version 4.0 and later, see Upgrading to version 5.0.2. If you are upgrading from a version 3 release, first upgrade to a version 4 release, preferably the latest 4.0.x release. For more information, see Upgrading from version 3 to the current version.

If you are upgrading from a release that is earlier than 4.0.1 in a distributed environment (CLM applications are on separate servers) and you will not upgrade all CLM applications to 5.0.2, a mandatory workaround provides the appropriate base licenses that are required for the upgrade. See Work item 251460: Incorrect documentation for upgrading JTS and apps in a staged fashion when going from pre-4.0.1 to post 4.0.1 CLM release.

1. Install the new Jazz Team Server.
2. Install any missing licenses from the 4.0 functional client access licenses (CALs) .zip file by using the Admin licensing page in the web client. Use the ContributedCALs40xCompatible.zip file, which is available to download from this page.
3. If you are upgrading the CCM application, first go to the Admin licensing page in the web client and delete the following CALs:
   • CCM Data Collector
   • Build System
   • ClearCase Synchronizer
   • ClearQuest Synchronizer
   Then, proceed with the upgrade of the CCM application.
4. If you are upgrading the QM application, go to the Admin licensing page in the web client and delete the following CALs:
   • QM Data Collector
   • RQM Connector
   Then, proceed with the upgrade of the QM application.
5. Restart Jazz Team Server.