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.
If you are upgrading web-based server components, install the WebSphere Application Server and IBM HTTP Server. Server Install WebSphere Application Server for Rational ClearCase The ClearQuest V8.0 upgrade program removes earlier versions of Rational ClearQuest, including the Websphere Application Server and IBM® HTTP Server that were previously installed as part of product installation. See Considerations for upgrading ClearQuest server components
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  
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.
If you are a Windows Vista user, you must have Administrator access to install into the C:\Program Files directory. Client

Server

User privilege requirements for installing the product  
Upgrade the license server to Rational Common Licensing 8.1.1. Client

Server

Upgrading the Rational License Key Server
Attention:
  • If you are upgrading from version 7.0.x or 7.1.1 to version 8.0, you must upgrade your license server to Rational Common License version 8.1.2 If the license server is not upgraded, then Rational ClearQuest 8.0 users cannot contact the license server. Rational Common Licensing version 8.1.2 is backwards compatible. You can use Rational Common Licensing version 8.1.2 with Rational ClearQuest version 7.1.1 and earlier.
  • 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

Installation of License Key Administrator 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.1 or 8.1.2 with Rational ClearQuest version 8.0.
Note: You cannot install LKAD version 8.1.1 at the same time you are upgrading to Rational ClearQuest version 7.1.2.
Rational License Key Administrator (LKAD) looks for the product-specific license key first. Client

Server

Change to search order for license keys In previous releases, LKAD first looked for a license key that corresponded to Rational Suite
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 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