Installing Rational ClearQuest

Information about installing 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. See the IBM Installation Manager Information Center for more information: http://publib.boulder.ibm.com/infocenter/install/v1r4/index.jsp?topic=/com.ibm.cic.agent.ui.doc/topics/c_cap_overview.html

Important: If you have not already done so, review the information in Planning your deployment before starting a Rational ClearQuest installation.

Tip: To determine the version of the Installation Manager Information Center that you are using, go to the Welcome page: http://publib.boulder.ibm.com/infocenter/install/v1r4/index.jsp

For interactive guidance on which information center topics you will need for your site installation, see Create a road map for installing IBM Rational ClearQuest.

For information about detailed steps for several installation scenarios, see Installation scenario walkthroughs. This section provides step-by-step instructions for four common installation scenarios for ClearCase and ClearQuest.

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

Table 1. Installation
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, you must use the rationaluninstalltool.exe tool to uninstall previous versions of Rational products that were installed with the MSI based install 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, then you must 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 larger than 1024.
Windows Vista users must have Administrator access if installing into the C:\Program Files.	Client Server	Windows Vista user privilege requirements for using 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	Note: If you are installing Rational ClearQuest version 7.1.2, you can install LKAD at the same time. When you use the launchpad program to install Rational ClearQuest, LKAD is listed in the packages available to install. If you are upgrading Rational ClearQuest version 7.1.2., you cannot install LKAD at the same time. You must install LKAD after upgrading Rational ClearQuest.
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 Installing on platforms that do not use the GUI Sample response files used for silent installs: http://www-01.ibm.com/support/docview.wss?rs=0&uid=swg21348204	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	If you have a MultiSite configuration and you are upgrading from version 2003.06.xx, install version 7.1.x of the Rational ClearQuest MultiSite Administration 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.