Upgrading the software

When a new version of software becomes available, you can perform an upgrade. Use IBM® Installation Manager to update the software installation.

Before you begin

Note:

You cannot upgrade IBM Rational® Test Workbench Web UI Tester, IBM Rational Performance Tester, and IBM Rational Functional Tester from any version of the product to version 9.1. All earlier versions of the product must be uninstalled before installing version 9.1.

To upgrade Rational Integration Tester and Rational Test Control Panel packages from version 9.1 to version 9.1.1, use the Update procedure in IBM Installation Manager (by using the Check for other versions, fixes, and extensions option). If you have an older version, you must first upgrade to version 9.1 and then upgrade to version 9.1.1. For install instructions, see Installing the product software.
Note: The upgrade process removes the customized trust stores that are located at Rational Test Contol Panel installation location\usr\servers\RTCPServer\resources\security, if any. Ensure that you create a backup copy of the trust stores before upgrading.

If you upgrade from a previous version of Rational Test Control Panel, all communications with the software by default use HTTP on port 7819. To use HTTPS by default during the upgrade of the Rational Test Control Panel software, you must use the Install option in IBM Installation Manager and click Check for Other Versions, Fixes, and Extensions in the Install Packages dialog; otherwise, you continue to use HTTP on port 7819. You can change the port number and enable HTTPS even after the installation. For details, see Configuring the server HTTP Endpoint.

  • Read the release notes to learn about any conditions for the upgrade. Generally, it is possible to upgrade without uninstalling the existing version but some releases might have some restrictions.
  • Read the upgrade considerations for your product to know about any upgrade prerequisites or conditions, and for any data preservation or migration requirements.
  • Have your IBM ID and password ready to access the upgrade package. This ID is linked to your IBM Passport Advantage account and is the same one that you use to install the software.

About this task

You can update your software in two ways:
  • Online mode: This method requires an internet connection. Installation Manager connects to the IBM update repositories that are preconfigured when the product is installed, and downloads and installs the update package.
  • Offline mode: While connected to the internet, download the package from the IBM update repository and extract the files to a temporary location. Then in offline mode, run Installation Manager and update the installation.

Procedure

  1. Start Installation Manager.
  2. To install the update in offline mode, follow these steps, else go to step 3.
    1. Download the update package from the IBM repository. For information about the repository location, see the Download document for the release. The download document is available on the IBM Support website.
    2. Extract the package to a temporary location on your computer.
    3. In Installation Manager, click File > Preferences.
    4. Click Add Repository and add the path to the repository.config or the disktag.inf file in the package that you extracted.
    5. Click OK.
  3. On the Installation Manager main page, click Update.
  4. Select the package to update. Click Next.
  5. Review and accept the terms of the license agreement. Click Next. Installation Manager searches the online and local repositories to verify the upgrade package.
  6. Enter your IBM ID and password when prompted. Click OK.
  7. Review the update package. To start the update, click Update.
  8. After the update finishes, click Finish.

Feedback