Upgrading Rational ClearQuest

Read this section for an overview of the steps to follow in upgrading IBM Rational® ClearQuest®.

Starting with release 7.1, IBM Installation Manager is used to install Rational ClearQuest. Installation Manager is a program for installing, updating, and modifying packages. It helps you manage the IBM applications, or packages, that it installs on your computer. Installation Manager does more than install packages: it helps you keep track of what you have installed, determine what is available for you to install, and organize installation directories. Go to the IBM Installation Manager Information Center for more information: http://publib.boulder.ibm.com/infocenter/install/v1r4/index.jsp.

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 Rational ClearQuest servers, including the 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.
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.
If you are on Linux or the UNIX® system and you want to enable the product to be used by users other than root, set the umask variable to 0022 before you install the product. Client

Server

To set this variable, log in as root user, start a terminal session, and 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

Windows Vista user privilege requirements for using the product  
Upgrade the license server to Rational Common Licensing 8.1.1. Client

Server

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

Installing on platforms that do not use the GUI

Sample response files used for silent installations: http://www-01.ibm.com/support/docview.wss?rs=0&uid=swg21348204

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

Server

IBM Installation Manager tasks Information for Windows, Linux, and the UNIX system platforms. Does not provide details on installing from Rational ClearQuest's launchpad.
Optionally, use the launchpad to install Rational ClearQuest. Client

Server

Installing from the launchpad program Steps on installing Rational ClearQuest using the Rational ClearQuest launchpad.
Install Rational ClearQuest 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.
Install synchronization and Rational Shipping Servers. Server If you have a MultiSite configuration and you are upgrading from version 2003.06.xx, install version 7.1.x of the Rational ClearQuest MultiSiteAdministration Tools as your synchronization server, and the Rational Shipping Server. You must upgrade all of your synchronization servers and shipping servers to version 7.1.x at the same time.

Feedback