Installing Rational ClearQuest

Information about installing IBM Rational® ClearQuest®
Before installing ClearQuest clients and servers, make sure you are prepared:
Note: For interactive guidance on which information center topics you will need for your site installation, see Interactive guidelines worksheet for installing Rational ClearQQuest

Installation set up, deployment, and configuration tasks required to deploy ClearQuest vary depending on your deployment plan and site configuration. Before installing, review Installation scenario walkthroughs to learn about install tasks required for four different installation scenarios.

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

Table 1. Installation
Task Component Information Comment
Identify an installation strategy Client

Server

Installation scenario walkthroughs Review the installation scenario walkthroughs which provide step-by-step instructions for installing for four common scenarios for Rational ClearQuest. Identify the scenario that works best in your environment. After selecting a scenario, determine which installation tasks are required for your deployment.
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.
Install WebSphere Application Server and IBM HTTP Server. Server Installing WebSphere Application Server and IBM HTTP Server Complete this task for environments that will use any of these ClearQuest web-based components:
  • ClearQuest Web server
  • ClearQuest Full-Text Search
  • ClearQuest Report Server for Crystal Reports
  • Report Launcher for ClearQuest
If you have any version 7.0 or earlier Rational products on your computer that were installed with an MSI-based installer, you must use the rationaluninstalltool.exe tool to uninstall them before installing version 8.0 products. 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.
 
If you are on Linux or the UNIX system increase the number of file handles available before you install the product. Client

Server

Increasing the number of file handles on Linux workstations How to set ulimit to a number larger than 1024.
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
Windows users must have Administrator access if installing into the C:\Program Files. Client

Server

User privilege requirements for installing the product  
Installing Rational License Key Server version 8.1.1 Client

Server

Setting up the Rational License Key Server This link opens the Rational Common Licensing Information Center.
Windows Only:

Install Rational License Key Administrator (LKAD)

Client

Server

Installation of License Key Administrator  
Rational License Key Administrator (LKAD) looks for the product-specific license keys 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 ClearQuest response files used for silent installs

Information about silent installations.
How to 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. Does not provide details on installing from the Rational ClearQuest launchpad.
Using the launchpad to install Rational ClearQuest Client

Server

Installing from the launchpad program Steps about 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 see in Installation Manager when installing Rational ClearQuest.
Install 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