Upgrading Rational ClearQuest

Review the upgrade information and complete optional and required tasks for upgrading IBM Rational® ClearQuest®.
Before upgrading ClearQuest clients and servers, make sure you are prepared:
Important: If you have not already done so, review the information in Planning your upgrade before starting an Rational ClearQuest installation.

For information about printing Information Center topics, see Creating a PDF or printing topics.

Table 1. Installation and upgrade tasks
Task Client and/or Server Information Comment
Shut down the servers and databases. Client

Server

Shut down the WebSphere Application servers for Rational ClearQuest Web servers. Shut down the Rational ClearQuest databases, using the processes specific to each vendor database. Then shut down all other IBM Rational products. This action prevents Rational ClearQuest clients from accessing or updating the databases.
Verify that you have a supported version of WebSphere Application Server and IBM HTTP Server installed and configured Server Prepare the WebSphere Application Server environment for ClearCase and ClearQuest web servers Rational ClearQuest version 8.0.1 requires WebSphere Application Server and IBM HTTP Server 8.0 or 8.5. Before upgrading, seeUpgrade ClearQuest Web Server features: considerations and best practices.
On Windows systems, disable Terminal Services Server Disable Terminal Services before installing, upgrading, or modifying Rational products  
Before installing Rational products with Installation Manager, use the rationaluninstalltool.exe tool to uninstall previous versions of Rational products that were installed with the MSI-based installation technology. Client

Server

Uninstall Rational products, version 7.1 and earlier  
Confirm that your user ID meets the required access privileges for installing the product. Client

Server

User privilege requirements for installing the product Requirements for Linux and Windows users.
To make products available to non-root users, set the umask variable to 0022, before you install ClearQuest on a Linux or UNIX system. Client

Server

To set the umask variable:
  1. Log in as root user.
  2. Start a terminal session.
  3. Type umask 0022.
 
Check the downloaded electronic images. Client

Server

Verifying and extracting electronic images  
Use the IBM Packaging Utility if you want to install multiple Rational products in the same repository. Client

Server

IBM Packaging Utility You can use the Packaging Utility to perform the following tasks:
  • Generate a new repository for packages
  • Copy packages to a new repository
  • Delete packages that are no longer needed
For best results, before you work with your Rational product, increase the number of file handles available. Client

Server

Increasing the number of file handles on Linux workstations How to set ulimit to a number significantly larger than 1024.
Verify that the user or administrator upgrading the product has the required access privileges. Client

Server

User privilege requirements for installing the product  
Upgrade Rational licensing software Client

Server

Upgrading the Rational License Key Server This step is required only when upgrading from version 7.0.x or 7.1.1 to version 8.0.1.
Attention:
  • This step is required only when upgrading from version 7.0.x or 7.1.1 to version 8.0.1 or later. If the license server is not upgraded, thenRational ClearQuest 8.x users cannot contact the license server.
  • If you are upgrading from version 7.1.2, this step is not required. Version 7.1.2 uses Rational Common Licensing 8.1.1, which is compatible with this release.
Windows Only:

Install Rational License Key Administrator (LKAD)

Client

Server

Installing License Key Administrator When you upgrade from ClearQuest version 7.0.x or 7.1.1 to version 8.0, LKAD versions 8.0 and earlier are uninstalled when you upgrade to Rational ClearQuest version 8.0. You receive the License Key Administrator Removal Warning that indicates LKAD will be uninstalled. You must click the License Key Administrator Removal Warning to see the warning text. You must use LKAD version 8.1.3 with Rational ClearQuest version 8.0.1.
Note: You cannot install LKAD version 8.1.1 at the same time you are upgrading to Rational ClearQuest version 7.1.2.
Install Rational ClearQuest silently.
Note: This step is optional unless you are installing on a platform that does not use the GUI.
Client

Server

Installing silently

Sample response files used for silent installations:

Information about silent installations.
Optionally, manually run the commands install, start, and uninstall for Installation Manager. Client

Server

IBM Installation Manager tasks  
Optionally, use the launchpad to install Rational ClearQuest on Windows platforms. Client

Server

Installing from the launchpad program Steps on installing Rational ClearQuest using the Rational ClearQuest launchpad.
Upgrade Rational ClearQuest by using Installation Manager. Client

Server

Installing the product package using the Installation Manager GUI Description of the screens you will see in Installation Manager when installing Rational ClearQuest.
Upgrade ClearQuest Web server features: Server See Upgrade ClearQuest Web Server features: considerations and best practices You can upgrade these server components.
  • ClearQuest Web Server
  • Full-Text Search Server
  • Report Launcher for ClearQuest
  • Report Launcher for Crystal Reports
  • Multisite Shipping Server

The ClearQuest Web Server and reporting features are installed in the same profile. These components must all be upgraded at the same time.

Upgrade synchronization and Rational Shipping Servers. Server ClearQuest MultiSite Installation You must upgrade all of your synchronization servers and shipping servers at the same time.

Feedback