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.
The following variables are used in path names in this topic:
- CMServer-install-dir
- Directory where the CM Server is installed
- HTTPServer
- Computer name where the IBM HTTP server is installed
- WebSphere-install-dir
- 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:\WebSphere-install-dir\profiles\profile-name\node-name\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\config
- On the UNIX system and Linux:
WebSphere-install-dir/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.