RRDI upgrade troubleshooting

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

This page is the starting point for information and techniques to help diagnose and troubleshoot upgrade issues when upgrading Rational Reporting for Development Intelligence (RRDI) servers.

Before upgrading

• Check the Known issues as a prerequisite for the upgrade
• Backup your current RRDI Configuration
• Ensure that your current environment meets all the requirements by checking the Environment checklist and Version Compatibility
• Perform the upgrade in a test environment prior to upgrading your production environment

Upgrade Philosophy

During an RRDI Upgrade, you may be advised on some 'philosophies' on how to be best successful in your upgrade. Below we discuss some of these items.

Always upgrade CLM before RRDI

We advise the upgrade of CLM prior to RRDI to ensure that the data warehouse is at the correct level prior to an RRDI upgrade. If you choose to upgrade RRDI first, be prepared to see a "The datawarehouse was created by a previous version" error. The workaround is discussed below under Performing the Upgrade.

Always keep RRDI and CLM at the same version level

This is a recommendation to ensure that you are using a tested compatible version of both products, as well as utilizing all features or changes. However, this is not a hard rule. See Version Compatibility for more information on which versions are supported together if you cannot keep RRDI and CLM at the same version.

You must download RRDI Installation Repository to install

While you have the option to download the RRDI Installation Repository from jazz.net to install RRDI, you can also upgrade in-place referencing the repositories on jazz.net.

Performing the upgrade

This section will discuss known issues that can occur during the outlined steps of the upgrade for the Rational Reporting for Development Intelligence server.

Install the new version RRDI

• Some installation issues:

Technote 1665912: RRDI Installation or upgrade fails with wrong MD5

Technote 1567843: Installation fails with error "CRRRD4515E Error creating table spaces"

Installing Websphere for use with RRDI

Starting the setup wizard for RRDI and proceeding with its configuration

• The following article Workarounds: Setup problems in RRDI 2.0.3 discusses known issues with RRDI Setup problems

Error "The datawarehouse was created by a previous version"

This error is indicative that the datawarehouse used by a CLM application was created with an older version. For example, if you are upgrading RRDI to 2.0., this error may occur if CLM is at version 3.0.1. This error is document in Technote 1614140: Running RRDI Setup during upgrade results in Previous Version error.

Deploying report resources results in CRRRA2083E

Upon deploying the report resources in the setup wizard for RRDI, the following error is seen:

CRRRA2083E: Cannot connect to the report server

For information on this error, see [Technote 1652043: Upgrading RRDI results in CRRRA2083E error during RRDI setup

Uninstalling the previous version of RRDI

Issues after upgrade

• Check the documented workarounds for known issues

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,