Upgrade troubleshooting

Authors: StephanieBagot, UpgradeTroubleshootingTeam
Build basis: CLM 3.x and later

This page is the starting point for information and techniques to help diagnose and troubleshoot upgrade issues when upgrading the Rational Collaborative Lifecycle Management (CLM) family of products (Rational Team Concert, Rational Requirements Composer, and Rational Quality Manager).

How to use this upgrade troubleshooting guide

If this is the first time visiting this page, you may want to start by reading "Initial Upgrade Troubleshooting Investigation" which contains basic steps for analyzing upgrade issues in your Jazz environment.

Before upgrading

• Before running the upgrade - Check the Known issues to ensure that you have all the required hotfixes applied to your current version as a prerequisite for the upgrade
• Before running the upgrade - Ensure that your current environment meets all the requirements by checking the Environment checklist

Performing the upgrade

Below are the steps necessary to complete a successful upgrade. Each item below discusses common issues seen at that particular step within the upgrade process.

• Run the upgrade script or alternatively Running the upgrade manually
  • Update configuration files (CCM, Quality Management, Jazz Team Server)
  • Add database tables (CCM, Quality Management, Jazz Team Server)
  • Upgrade the data warehouse schema (Jazz Team Server)
• Start the applications
• Licenses
• Migrating the Requirements Management application
• Redeploying predefined templates

After the upgrade

If your upgrade was successful, but your users report the following:

• Various functions are not working as expected, or not working the same as the pre-upgrade version
• Some data, such as item statuses, are corrupted after the upgrade
• Full text queries fail
• Dashboard issues

Navigate to Common issues that occur after the upgrade for information on troubleshooting and debugging.

Where do I go from here?

If you are unable to resolve your issue using the available online resources, open a service request with IBM Rational Support. Refer to Additional troubleshooting resources for further details.

Related topics: None

External links:

• None

Additional contributors: StephanieBagot, SusanWu, MichaelAfshar, WilliamChen, BrettBohnn