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).
Before upgrading
Before you start the upgrade process, verify the integrity of the database by runing the -verify repotools command.Planning to upgrade to version 5? See the RRC 4.x to 5.x migration tips and tricks article for known issues
Check the Known issues for awareness of issues in the current version as a prerequisite for the upgrade
Ensure that your current environment meets all the requirements by checking the Environment checklist
Perform the upgrade in a test environment prior to upgrading your production environment
Go through the Upgrade Insider page of the deployment wiki for further information about your upgrade
Contact IBM Support and open up a proactive PMR with your upgrade plan and environment specifics. This will ensure Support is aware of the upgrade and can plan accordingly to become familiar with your environment and plan, resulting in faster response times.
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.
Verify there are no diagnostic errors on any application
Verify you are able to navigate between linked project areas
Verify there are no errors in process configuration (particularly for customized project areas)
Consider you or your users completing an Upgrade Verification to ensure the upgrade was successful (not all steps may apply in each environment).
Consider running an Online Verify which will check the consistency of the data.
User Validation:
Access work items, saving, creating new work items (verify no information is missing)
View plans (verify no information is missing)
View Dashboards; ensure all are working with no errors
Load Reports
Access Source Control (checkin, checkout, deliver)
Issues during user verification testing after 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
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.