Installing ClearQuest Web server

Use the Rational® Installation Manager to install the ClearQuest® Web server.

Before you begin

The ClearQuest Web server must be deployed on a server that has a stand-alone implementation of WebSphere® Application Server and IBM® HTTP Server installed and configured.

This topic presents information about WebSphere Application Server version 7. For information about installing the WebSphere Application Server and IBM HTTP Server, see Installing WebSphere Application Server and IBM HTTP Server. For information about installing and configuring WebSphere Application Server and IBM HTTP server version 8, see Technote #1569987,

About this task

ClearQuest Web server provides server-side support for WAN interfaces to IBM Rational® ClearQuest®. These instructions are for installing the server by using the IBM Installation Manager. During installation, you can install the server in a new profile or install it in an existing WebSphere Application Server profile. For information about selecting a profile during installation, see Using WebSphere Application Server V7.0 profiles for web feature deployment.

Procedure

  1. Disable Anti-virus software and stop any of the following services if they are running: WebSphere Application Server, IBM HTTP Server, Atria Location Broker, IBM WebSphere Application Server v7.x – cqwebprofile, IBM Rational ClearQuest Mail Service.
  2. Start the IBM Installation Manager.
  3. Click Install to start the installation process.
  4. On the Licenses page, review the license terms. If they are acceptable, click I accept the terms in the license agreement.
  5. On the Install Packages page, click the IBM Rational SDLC package. Then, click Next.
  6. On the Install Packages - Select the features to install page, select the ClearQuest Web Server feature. Click Next.
  7. Specify the installation settings for the IBM HTTP Server.
    1. On the page Install Packages -Specify the configurations for the packages, click the IBM HTTP Server option in the navigation pane.
    2. In the IBM HTTP Server page, make sure Automatically configure IBM.HTTP Server is selected.
    3. Confirm that the path to the IBM HTTP Server configuration file is correct. This configuration file is created as part of the IBM HTTP Server installation process. If the default path is not correct, an error message is displayed. Click Browse to select the correct path. Click Next.
  8. Specify the installation settings for the WebSphere Application Server.
    1. Select the Profile Deployment Type option from the dropdown list, or accept the default selection.
      • Use an existing Web Application Server profile
        1. Type or select the path for the Application server profile location.
        2. The value of the WebSphere Application Server version is set automatically based on the WebSphere Application Server version when the profile was created.
        3. Start the WebSphere Application Server for the profile:
          Windows
          Go to Start > Programs > IBM WebSphere > Application Server V7.0 > Profiles > Start the server or run this command:
          was_profile/profile_name/bin/startServer.bat server1
          UNIX/Linux
          Run this command:
          was_profile\profile_name\bin\startServer.sh server1
        4. Click Get List From Server.

          Wait for the installer to finish fetching the list of servers and clusters.

        5. Select a server from the list of available servers.
        6. After the installation is complete, restart your computer when prompted by Installation Manager.
      • Create a new Web Application Server profile
        1. Type or select the location of the WebSphere Application Server home directory. The default path is C:\Program Files\IBM\WebSphere\AppServer.
        2. Accept the default path for New application server profile location or type or browse to a different location.
        3. The value of WebSphere Application Server version is set automatically.

Results

After the installation completes, verify that the ClearQuest Web application is installed and that the IBM HTTP Server routing is configured correctly:
  1. To verify the ClearQuest WebSphere Application Server installation, open a browser and go to http://server_name:profile_http_transport_port/cqweb.
    Where profile_http_transport_port is the port where the ClearQuest Web Server application was deployed. If you deployed to a new profile, the port number is 12080. You can find the port value in the profile information file HTTP Transport port property located in one of the following locations:
    • For new profile deployments, go to cq_profile_dir/logs/AboutThisProfile.txt
    • For existing profile deployments, go to was_profiles_dir/profile_name/logs/AboutThisProfile.txt
  2. To verify that automatic configuration of the IBM HTTP Server succeeded, open a browser and go to http://server_name/cqweb.

    The automatic configuration enables ClearQuest client requests to be routed through the IBM HTTP Server to the WebSphere Application Server. If you cannot access the ClearQuest web application server, you must manually configure the routing in the IBM HTTP Server configuration file http.conf. See Manually configuring IBM HTTP Server routing to the WebSphere Application Server.

What to do next

See Configuring ClearQuest Web server.

Feedback