Rational Integration Tester upgrade information and requirements

Upgrading the software

No direct upgrade paths to the latest version are supported. To upgrade Rational® Integration Tester, Rational® Test Control Panel or Rational® Integration Tester Agent packages to the latest version, uninstall any previously installed version and install the latest version. For install instructions, see Installing the product software.

Restriction: Upgrading Rational® Integration Tester from previous versions is not supported on Mac operating systems.

Note: From version 8.7.1 onwards, the Rational® Integration Tester Platform Pack component does not exist. All the technology-specific tool packages and the HTTP/TCP proxy components are now available with Rational® Test Control Panel. For more information, see product tool packages.

Before you upgrade the Rational® Integration Tester software

Before you upgrade an existing Rational® Integration Tester installation, read the release notes for the latest version of the software to learn about changes that might affect your use of Rational® Integration Tester, especially any new features.

Installation dependencies and considerations

The various components of the Rational® Integration Tester virtualization environment are designed to work together. In normal operation, all components ( Rational® Integration Tester, Rational® Test Control Panel, and Rational® Integration Tester Agent ) must all be at the same version. Otherwise, version-mismatch errors occur. An exception to this is Rational® Test Control Panel, which supports older versions of agents and proxies registering with it. When you upgrade components, upgrade Rational® Test Control Panel before you upgrade Rational® Integration Tester Agent and proxies.

Compatibility of existing Rational® Integration Tester projects

In general, Rational® Integration Tester projects are compatible when used in the same major version of Rational® Integration Tester. For example, a project that is created in Rational® Integration Tester version 8.0 works in Rational® Integration Tester Version 8.5. Also, projects you create by using any release of version 8.0 are entirely compatible with version 9.2. GreenHat Tester 5 projects can be opened in Rational® Integration Tester 8.0. It is also possible to migrate GreenHat Tester 4 projects to Rational® Integration Tester 8.0. However, projects from releases earlier than GreenHat Tester 4 cannot be migrated to Rational® Integration Tester 8.0.

Attention: After a project is loaded into a newer version of Rational® Integration Tester, it might not operate correctly if it is then loaded into a previous version. Therefore, it is essential to use a copy of each of your projects during upgrade testing.

Library Manager settings

Library Manager settings and most user preferences are preserved during the uninstallation or reinstallation process. During the installation of Rational® Integration Tester, run Library Manager at the end of the process and confirm that the settings are correct. Perspective and dialog layout preferences are reset. If you use the Rational floating license server, set up the license server hostname again after installation. To do this, enter the Manage License area of Installation Manager, and enter the floating license hostname details.

Note: Library Manager writes some of its configuration details to a directory within the users home directory called .integrationtester, and to the Rational® Integration Tester installation directory. To ensure that Library Manager can write to the Rational® Integration Tester installation directory, the user ID that is used to install Rational® Integration Tester must be used when running Library Manager.

For information about Library Manager, see Working with the Library Manager.

Verifying and upgrading the results database schema

After you upgrade IBM® Rational® Integration Tester, or uninstall an older version to move to a newer version (when the upgrade is not applicable), verify that the schema version of the Rational® Integration Tester project results database in use is correct for the new version of Rational® Integration Tester. Update the schema if required.

To know the required schema version, do either of the following actions:

See the release notes for the release.
On the menu bar, click Project > Project Settings. Open the Server Settings tab and select a database provider.

To verify and update the schema:

Verify the schema version in use:
- On the menu bar, click Project > Project Settings. Select the Server Settings tab.
- Click Test Connection
The schema version in use must be compatible with the new version of the software as mentioned in the release notes.
To upgrade the schema, see Upgrading the project results database schema.