Interactive installation guide

This guide describes installing the Rational Adapter for HP ALM.

Select options that best describe your installation environment

Choose the operating system for your adapter installation:
Choose your application server to run the adapter web application:

To install the Rational Adapter for HP ALM follow these steps:

Plan the adapter installation

Before you install the Rational Adapter for HP ALM, ensure to review the information in the following planning checklist.

  Planning task More information
Verify that your hardware and software meet the minimum system requirements. System requirements
Get the product installation media. Downloading the adapter installation media
Review the installation topology. Installation topology
Review the installation process. Installation process
Learn about processor value unit licensing. Understanding processor value unit licensing

Install the adapter

Install the Rational Adapter for HP ALM from DVD or electronic image using Installation Manager, see Installing the adapter using Installation Manager

Set up processor value unit pricing

Measure processor value units by which the adapter is licensed, see Setting up processor value unit pricing.

Set up the Apache Tomcat server to host the adapter

Secure the server by installing a security certificate, see Installing a security certificate for Apache Tomcat.

Deploy the adapter web application and start the server, see Starting the Apache Tomcat server that hosts the adapter.

Set up the WebSphere Application Server to host the adapter

Tip: When using the IBM Installation Manager to install the products, the web application files can be installed into a webapps directory. During the installation process, you should not install the included Tomcat Application Server v5.5; this makes the Installation Manager ask for a web application directory and install only the files needed for WebSphere. If you have installed Tomcat, the web application files are under HPInstallDir/server/tomcat/webapps. If you have not installed Tomcat, the web applications are under the directory you specified during the installation. The default directory is HPInstallDir/server/webapps.

Secure the server, install a security certificate, see Installing a security certificate for WebSphere Application Server.

Create an application server profile, which makes it easy to keep the Rational Adapter for HP ALM web application separate from other applications and makes it easy to delete this profile from your computer if you uninstall the adapter, see Creating an application server profile.

Set up the database for the adapter, secure and install the adapter web application using Jython scripts, see Setting up a WebSphere Application Server by using Jython.

Deploy the adapter web application using Jython scripts, see Deploying the adapter web application using Jython.

Continue the adapter installation

You have installed the adapter, set processor value unit pricing, and set up the server to host the adapter.

There are several more tasks to complete.

Customize new HP ALM projects to work with the adapter, see Setting up new HP ALM projects.

Customize existing HP ALM projects to work with the adapter, see Setting up new HP ALM projects.

Establish server friend relationships from the adapter, see Establishing cross-server communication from Rational Adapter for HP ALM.

Approve a server friend request, see Approving an access request.

Establish server friend relationships from CLM, see Establishing cross-server communication from CLM.

Associate HP ALM projects to CLM project areas, see Linking between HP ALM projects and CLM project areas.