Deploying and configuring Rational ClearQuest Web on WebSphere Application Server

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:

  1. 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:
    • On Windows

      drive:\CQServerInstallDir\cqweb\cqwebws.ear

    • On the UNIX system and Linux

      CQServerInstallDir/cqweb/cqwebws.ear

    Do not install the Rational ClearQuest Web Application component.

  2. 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.

  3. 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

  4. 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

  5. Use the Update Web Server Plug-In Configuration page of the WebSphere administrative console to regenerate the plug-in configuration.
  6. Restart the HTTP Server.
  7. Start the Rational ClearQuest Web application.
  8. 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.



Feedback