This topic explains how to deploy Rational® ClearQuest® Web
on a separate WebSphere Application Server instead of the one that
is installed with CM Server when you install Rational ClearQuest Web.
Before you begin
The instructions assume that you are familiar with WebSphere
Application Server administration. For more information, see the
WebSphere Application Server Support Web page.
About this task
The following variables are used in path names in this
topic:
- HTTPServer
- Computer name where the IBM HTTP server is installed
- RATIONAL_COMMON
- Directory where the Rational common files are installed
- WebSphereHOME
- Directory where the IBM WebSphere Application Server is installed
The following figure shows CM Server and ClearQuest Web deployed
on the same WebSphere Application Server.

To deploy ClearQuest Web on
a separate WebSphere Application Server:
- Install the ClearQuest Web and
CM Server software following the installation instructions. When you install the ClearQuest Web software,
the ClearQuest Web
application EAR file is copied to this location:
Attention: Do not install the ClearQuest Web application
EAR file yet.
- Deploy CM Server on WebSphere Application Server.
- Use the WebSphere Application Server administrative console
to install the ClearQuest Web
application EAR file from the location specified in step 1. When installing
the EAR file, follow these guidelines:
- Do not change the default parameter values.
- If you change the name of the ClearQuest Web application,
do not use a name with embedded spaces.
- Save the installation to the master configuration.
- Edit the cqServerConn.properties file,
updating the TEAM_SERVER_URL property to specify
the directory where the CM Server component is installed. The cqServerConn.properties file
is located in the following directory:
- On Windows:
drive:\%WebSphereHOME%\profiles\profile-name\node-name\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\config
- On the UNIX system and Linux:
$WebSphereHOME/profiles/profile-name/node-name/RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/config
- Update the Web Server Plug-In Configuration page
of the WebSphere administrative console to regenerate the plug-in
configuration.
- Restart the IBM HTTP server.
- Start the ClearQuest Web application.
- Verify the ClearQuest Web application
configuration on WebSphere Application Server by entering the following
Web address in a client browser:
http://HTTPServer/cqweb
The
login page opens if your configuration is correct.