This topic summarizes how to deploy and configure Rational® ClearQuest® Web
on WebSphere Application Server.
The following variables are used in path names in this topic:
Table 1. Path name variables| Variable |
Definition |
| CQServerInstallDir |
Directory where the Rational ClearQuest Web
Server component is installed. |
| WebSphereInstallDir |
Directory where the WebSphere Application Server is
installed. |
| WebSphereComputer |
Computer where the WebSphere Application Server is installed. |
| HTTPComputer |
Computer where the HTTP Server is installed. |
To deploy and use WebSphere Application Server with Rational ClearQuest Web:
- Install the Rational ClearQuest Server
component of Rational ClearQuest Web,
following the instructions in IBM Rational ClearQuest and ClearQuest MultiSite
Installation and Upgrade Guide.
When you install the ClearQuest Server component, the ClearQuest Web Application
EAR file is copied to this location:
Do not install the Rational ClearQuest Web
Application component.
- 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.
Do not start the Rational ClearQuest Web
Application.
- If the Rational ClearQuest Request
Manager is on a different machine from that on which the WebSphere Application
Server is installed, modify the file jtl.properties,
as described in Configuring the Rational ClearQuest server properties on multiple computers.
This file is copied to the following location when you deploy New ClearQuest
Web on WebSphere Application Server:
- On Windows
drive:\WebSphereInstallDir\installedApps\ WebSphereComputer\RationalClearQuestWeb.ear\CQWebModule.war\WEB-INF\classes\jtl.properties
- On the UNIX system and Linux
WebSphereInstallDir/installedApps/WebSphereComputer/RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/classes/jtl.properties
- Edit the following property values in the common.properties file, located
in the same directory as the jtl.properties file.
In
the file common.properties, path names for Windows, Linux, and the UNIX system
require a forward slash (/) as the path delimiter.
- CQ_WEB_SERVER_NAME
- If the HTTP Server and the WebSphere Application Server are running on
different computers, change this value to the computer name on which the HTTP
Server is running. Otherwise, keep the default value.
Default: localhost
- PROPERTIES_DIR
- Enter the full path name where you copied the Rational ClearQuest Web
Application EAR file using the following syntax:
- On Windows
drive:/WebSphereInstallDir/installedApps/WebSphereComputer/RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/classes
- On the UNIX system and Linux
WebSphereInstallDir/installedApps/WebSphereComputer/RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/classes
For example, on Windows:
PROPERTIES_DIR=C:/Program
Files/WebSphere/AppServer/installedApps/mickey/RationalClearQuestWeb.ear/CQWebModule.war/WEB-INF/classes
- UPLOAD_DIR
- Enter the full path name used by the Rational ClearQuest Web
Application to upload attachments to the ClearQuest Server. Use the following
syntax:
- On Windows
drive:/WebSphereInstallDir/installedApps/WebSphereComputer/RationalClearQuestWeb.ear/
CQWebModule.war/htdocs/cqattachments
- On the UNIX system and Linux
WebSphereInstallDir/installedApps/WebSphereComputer/RationalClearQuestWeb.ear/CQWebModule.war/htdocs/cqattachments
For example, on Windows:
UPLOAD_DIR=C:/Program Files/WebSphere/AppServer/installedApps/mickey/RationalClearQuestWeb.ear/CQWebModule.war/htdocs/cqattachments
- DOWNLOAD_DIR
- Enter the relative path name (that is, relative to the WebSphere Application
Server installation directory) used by the Rational ClearQuest Server
to download attachments to the Rational ClearQuest Web
Application. Use the following syntax:
/cqweb/htdocs/cqattachments
For
example:DOWNLOAD_DIR=/cqweb/htdocs/cqattachments
- CHTRPT_DOWNLOAD_DIR
- Enter the full path name used by the Rational ClearQuest Web
Application to store report and chart data received from the server. Use the
following syntax:
- On Windows
drive:/WebSphereInstallDir/installedApps/WebSphereComputer/RationalClearQuestWeb.ear/CQWebModule.war/htdocs/cqchtrpts
- On the UNIX system and Linux
WebSphereInstallDir/installedApps/WebSphereComputer/RationalClearQuestWeb.ear/CQWebModule.war/htdocs/cqchtrpts
For example, on Windows:
CHTRPT_DOWNLOAD_DIR=C:/Program
Files/WebSphere/AppServer/installedApps/micky/RationalClearQuestWeb.ear/CQWebModule.war/htdocs/cqchtrpts
- CHTRPT_DOWNLOAD_URL
- Enter the relative path name (that is, relative to the WebSphere Application
Server installation directory) where the WebSphere Application Server stores
chart and report data. The HTTP Server uses this relative path to construct
the associated Web address. Use the following syntax:
/cqweb/htdocs/cqchtrpts
For
example:CHTRPT_DOWNLOAD_URL=/cqweb/htdocs/cqchtrpts
- Use the Update Web Server Plug-In Configuration page of the WebSphere
administrative console to regenerate the plug-in configuration.
- Restart the HTTP Server.
- Start the Rational ClearQuest Web
application.
- Verify the Rational ClearQuest Web
application configuration on WebSphere Application Server by entering the
following Web address in a client computer browser:
http://HTTPComputer/cqweb/login
If
your configuration is correct, the login page opens.