Deploying ClearQuest Web on a separate WebSphere Application Server

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 instructions assume that you are familiar with WebSphere Application Server administration. For more information, see the WebSphere Application Server Support Web page.

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.

This figure illustrates CM Server and ClearQuest Web deployed on the same WebSphere Application Server. An outer box represents the host computer. Within the outer box, a box on the left represents the IBM HTTP Server, which communicates using the HTTP protocol to a box on the right, representing the WebSphere Application Server. Within the WebSphere Application Server box, there is a box to the left representing Rational ClearQuest Web, which communicates using the HTTP/SOAP protocol to a box on the right, representing CM Server. CM Server communicates using RPC calls to the ClearQuest RPC Server and ClearQuest Core, both represented by a single box below and outside the WebSphere Application Server box.

To deploy ClearQuest Web on a separate WebSphere Application Server:

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

      drive:\CMServer-install-dir\cqweb\cqwebws.ear

    • On the UNIX system and Linux

      CMServer-install-dir/cqweb/cqwebws.ear

    Attention: Do not install the ClearQuest Web application EAR file yet.
  2. Deploy CM Server on WebSphere Application Server.
  3. 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.
  4. 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

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

Related concepts
Installing Rational ClearQuest
Using CM Server with IBM WebSphere Application Server

Feedback