Prerequisite planning for installing Rational® ClearQuest®

Information about installing Rational® ClearQuest®.

Before installing Rational® ClearQuest® clients and servers, make sure you are prepared:

Complete Rational® ClearQuest® installation planning including prerequisite tasks.
Understand how to install and use IBM® technologies for product installation.
Review installation scenario walkthroughs to learn about effective strategies for planning and using IBM® processes and tools to download and install IBM® software in different environments.
Consider printing installation checklist and planning topics so you can consult them during the installation process.

Use these resources and the installation checklist in Installation checklist to prepare your environment, complete prerequisite tasks, and install the product:

Planning the deployment and installation
About IBM® Installation Manager information centers
Creating a PDF or printing topics from the information center

Note: IBM ClearCase 9.0.2.x and IBM ClearQuest 9.0.2.x use a new Java version that is not compatible with the default Java version supplied with the IBM WebSphere Application Server profiles. Therefore, you must install IBM WebSphere SDK Java Technology version 8.0 or higher on hosts where you plan to install server features. For more details, see the technote IBM ClearCase 9.0.2.x and IBM ClearQuest 9.0.2.x Web server features require a compatible IBM WebSphere SDK Java Technology version.

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 for 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 DevOps 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 web servers	Complete this task for environments that will use any of these Rational® ClearQuest® web-based components: Rational® ClearQuest® Web server Rational® ClearQuest® Full-Text Search Report Launcher for Rational® ClearQuest®
On Windows™ systems, disable Terminal Services	Server	Disable Terminal Services before installing, upgrading, or modifying Rational ClearQuest
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 Rational® ClearQuest® on a Linux™ or UNIX™ system.	Client Server	To set the umask variable: Log in as root user. Start a terminal session. 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 DevOps 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 DevOps Common Licensing Information Center.
Windows™ Only: Install DevOps License Key Administrator (LKAD)	Client Server	Installing License Key Administrator
DevOps 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 DevOps 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.
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 DevOps Shipping Servers.	Server	ClearQuest® MultiSite Installation	You must upgrade all of your synchronization servers and shipping servers at the same time.