Installing Rational ClearQuest

Information about installing IBM Rational® ClearQuest®
Before installing ClearQuest clients and servers, make sure you are prepared: Use these resources and the installation checklist in Table 1 to prepare your environment, complete prerequisite tasks, and install the product:
Table 1. Installation checklist
Task Component Information Comment
Identify an installation strategy Client

Server

Installation scenario walkthroughs Review the installation scenario walkthroughs which provide step-by-step instructions forr four common installation 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 Prepare the WebSphere Application Server environment for ClearCase and ClearQuest web servers 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
On Windows systems, disable Terminal Services Server Disable Terminal Services before installing, upgrading, or modifying Rational products  
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, 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. Windows users must have Administrator access if installing into the C:\Program Files.
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.
 
In Linux or UNIX environments, 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 complete these following tasks:
  • Generate a new repository for packages
  • Copy packages to a new repository
  • Delete packages that are no longer needed
Install Rational License Key Server 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

Installing 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 an operating system 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