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
- 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.
- Start the IBM Installation
Manager.
- Click Install to start the installation
process.
- On the Licenses page, review the license terms. If they
are acceptable, click I accept the terms in the license
agreement.
- On the Install Packages page, click the IBM
Rational SDLC package. Then, click Next.
- On the Install Packages - Select the features to install
page, select the ClearQuest Web Server feature.
Click Next.
- Specify the installation settings for the IBM HTTP Server.
- On the page Install Packages -Specify the configurations
for the packages, click the IBM HTTP Server option
in the navigation pane.
- In the IBM HTTP
Server page, make sure Automatically configure IBM.HTTP
Server is selected.
- 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.
- Specify the installation settings for the WebSphere Application Server.
- Select the Profile Deployment Type option
from the dropdown list, or accept the default selection.
- Use an existing Web Application Server profile
- Type or select the path for the Application server
profile location.
- The value of the WebSphere Application Server version is
set automatically based on the WebSphere Application
Server version when the profile was created.
- 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
- Click Get List From Server.
Wait for
the installer to finish fetching the list of servers and clusters.
- Select a server from the list of available servers.
- After the installation is complete, restart your computer when
prompted by Installation Manager.
- Create a new Web Application Server profile
- Type or select the location of the WebSphere Application
Server home directory. The default path is C:\Program
Files\IBM\WebSphere\AppServer.
- Accept the default path for New application server
profile location or type or browse to a different location.
- 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:
- 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
- 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.