You can install, or upgrade, WebSphere Application Server
V8.5.x to support ClearCase CCRC WAN server and ClearQuest Web server
V8.0.1. Install a new instance of WebSphere Application Server before
installing and deploying web server components for Rational ClearCase,
or ClearQuest version 8.0.0.1, or later.
About this task
When you upgrade Rational Web components to V8.0.1, you
have the option to deploy the components on WebSphere Application
Server V8.5.x. Before you can deploy the upgraded Rational web components,
either upgrade the existing WebSphere Application Server to the new
version, or a separate V8.5.x instance.
ClearCase and ClearQuest
V8.0.1 Web components support deployment in WebSphere Application
Server version 8.0.0.x and 8.5.x.
Depending on the Rational
product version installed and the WebSphere Application Server version
used for deployment, upgrading to ClearCase CCRC WAN server, or ClearQuest
Web server V8.0.1, can require installing a new instance of the WebSphere
Application Server and IBM HTTP Server, or upgrading the existing
version.
You need to install a new instance of WebSphere Application
Server 8.5.x in any of the following cases, when you upgrade from:
- ClearCase or ClearQuest V7.1.1.x, V7.1.2.x to V8.0.1
- ClearCase or ClearQuest V8.0 or V8.0.0.1 installation deployed
to WebSphere Application Server V7.0.x
If you are upgrading to ClearCase, or ClearQuest V8.0.1, from
a V8.0.0.x installation deployed to WebSphere Application Server V8.0.0.x,
you have the option to upgrade the existing WebSphere Application
Server to version 8.5.x, or to continue using WebSphere Application
Server V8.0.0.x.
WebSphere Application Server and
IBM HTTP Server are installed using IBM Installation Manager. You
must install these components before installing Rational Web components
such as the ClearCase CCRC WAN Server or the ClearQuest Web server.
For
information on installing WebSphere Application Server version 8.5,
see TN# 1634430 Upgrading to ClearCase and ClearQuest
V8.0.1 with WebSphere Application Server and IBM HTTP Server V8.5.
Note: WebSphere
Application Server version 8 is not compatible with Rational ClearCase
or ClearQuest version 8.0 or earlier.
You can obtain WebSphere
Application Server and HTTP Server V8 from http://www.ibm.com/software/passportadvantageIBM
Passport Advantage. Fix packs are available from http://www.ibm.com/support/fixcentral/IBM Support
Fix Central.
- Restrictions
Before you begin an installation of WebSphere Application
Server version 8, review the following restrictions:
- Prepare your operating system for WebSphere
and IBM HTTP Server.
- See the ClearCase or ClearQuest release information on the IBM
Support website for current information about using these products
with WebSphere Application Server and IBM HTTP Server:
- On UNIX systems, do not use symbolic links as the destination
directory. Symbolic links are not supported.
- Do not use a semicolon in the directory name. WebSphere Application
Server cannot install properly if the target directory includes a
semicolon. A semicolon is the character used to construct the class
path on Windows systems.
- The maximum path length for the installation location on the Windows
Server 2008, Windows Vista, and Windows 7 operating systems is 60
characters.
- Deleting the default target location and leaving an installation-directory
field empty prevents you from continuing.
- Launch Installation Manager.
- Select , and add the installation repository for WebSphere
Application Server in the Repositories section
on the Preferences panel.
Tip: In Installation Manager, select Search service
repositories during installation and updates on the Installation
Manager Repository preference page. Then, if you are connected
to the Internet while you install, you can click Check
for Other Versions and Extensions to search for updates
in the default update repositories for the selected packages. In this
case, you do not need to add the specific service-repository URL to
the Installation Manager Repository preference
page. Select the fixes to install. Any recommended fixes are selected
by default. If there are recommended fixes, you can select the option
to show only recommended fixes, and hide non-recommended fixes.
- Click Install on the main Installation
Manager screen.
- On the Install Packages panel, select
the following packages to install, and then click Next to
continue the installation.
- IBM HTTP Server for WebSphere Application Server, Version
8.0.0.0 (or later)
- IBM WebSphere Application Server, Version 8.0.0.0 (or later)
- Web Server Plug-ins for IBM WebSphere Application Server,
Version 8.0.0.0 (or later)
- WebSphere Customization Toolbox, Version 8.0.0.0 (or later)
- If you want to install a fix pack for WebSphere Application
Server and IBM HTTP Server, such as version 8.0.0.1, select the Check
all versions and Check for Other Versions and
Extensions check boxes. The fix pack versions are displayed
in the list of packages. If they do not appear then the required repository
is not included in the preferences; in this case, see Installation
Manager tip in step 2. If package list is correct, click Next.
- If there are any fixes available, you are prompted to select
which ones to install. You should install all listed fixes. Select
the fixes to install, and click Next.
Note: If you have not authenticated to the IBM server, you
are prompted to enter an IBM user name and password authorized to
access the service repositories.
- Accept the license agreement, and click Next.
- On the Shared Resources Directory panel,
review any installation warnings and instructions.
- At the next panel, you can change the default installation
directory by selecting a package group name and specifying a new pathname
in the Installation Directory field. Click Next.
Note: If you change the install location of either the AppServer,
Plug-ins, or Toolbox, you might need to make the same change for the
others. Do not use locations that are already in use by another version
of WebSphere Application Server and IBM HTTP Server on the same machine.
- Select your translation choices, and click Next.
- At the Select the features to install panel,
verify that IBM HTTP Server, IBM WebSphere Application Server, Web
Server Plug-ins, and WebSphere Customization Toolbox are selected.
Accept default selections. Click Next.
- On the Configuration for IBM HTTP Server panel,
specify your web server configuration.
- Specify the port number for IBM HTTP Server communication. Use the default port 80, unless you must use an alternate port
to avoid a conflict.
- Optional: On Windows systems, choose whether
to run the IBM HTTP Server as a Windows service. You can
configure the service to run as local system account, or a user ID
that you specify. The user ID requires the following advanced user
rights:
- Act as part of the operating system.
- Log on as a service.
- Accept the default startup type, Automatic.
Important: If you do not select Run IBM
HTTP Server as a Windows Service, this instance of IBM
HTTP Server cannot be stopped or started by the WebSphere Application
Server administrative console. At any time after installation, you
can create a new service by running the following command: ihs_root/bin/httpd.exe
-n new_service_name -k install, and then update the web
server definition in the administrative console to reflect the new
service name.
- Click Next. Review the summary
information, and click Install.
If
the installation is not successful, or if error messages, are displayed
in the summary panel, review the installation log file. For troubleshooting
information, see IBM Support article http://www-01.ibm.com/support/docview.wss?uid=swg21573966.
When
the install completes successfully, you typically see a choice of
post-installation tools: - Optional. You can start installed components from the Start
program list in the Installation Manager, or start them
from the program shortcuts created during the WebSphere Application
Server installation process.
- WebSphere Customization Toolbox. You need this tool to configure
the HTTP plug-ins. This tool must be run on Windows as built-in Administrator
or as a local user in the Administrator group. For details, see APAR PM46369.
- Profile Management Tool. You can use this tool to create a WebSphere
Application Server profile if a web component will be deployed into
an existing profile. See WebSphere Application Server profiles for web feature deployment.
- Select the WebSphere Customization Toolbox to configure
the plug-in, and click Finish. If
you selected an application to start, the application starts after
the Installation Manager exits.
Note: If you do not see an option to
run the WebSphere Customization Toolbox, click the Windows Start menu: .
What to do next
The post-installation steps to complete the plug-in configuration
include:
- Optional. Configure a Web plug-in: If you have not already run
the Web Server Plug-ins Configuration Tool to configure the web server
to communicate with the application server, see Configuring a web plug-in for IBM HTTP Server in
the product information center. On Windows, this tool requires user
credentials for a built-in Administrator, or a local user in the Administrator
group. For details, see APAR http://www-01.ibm.com/support/docview.wss?uid=swg1PM46369
- Optional. Create a WebSphere Application Server application profile
When
you install Rational ClearCase and ClearQuest web components to a
WebSphere Application Server application profile, you can choose the
Profile Deployment Type: new profile, or existing
profile. To determine which type of profile to use, see http://pic.dhe.ibm.com/infocenter/cqhelp/v8m0r1/index.jsp?topic=%2Fcom.ibm.rational.clearquest.install_upgrade.doc%2Ftopics%2Fwas_install%2Fc_using_profiles_WAS.htm.
If you plan to deploy the product
web components to an existing WAS profile, make sure this profile
has already been created. Run the WebSphere Application Server Profile
Management Tool, or use the manage profiles script to create a WAS
profile. For instructions, see Information
Center.
- Upgrade Rational ClearCase CCRC WAN server and ClearQuest Web
Server to V8.0.1. See http://www-01.ibm.com/support/docview.wss?uid=swg21572830
Detailed information about installing and using WebSphere
Application Server V8.5.x can be found in the WebSphere Application
Server Information Center http://pic.dhe.ibm.com/infocenter/wasinfo/v8r5/index.jsp. Additional information is
available from the WebSphere Application Server education assistant
at http://publib.boulder.ibm.com/infocenter/ieduasst/v1r1m0/index.jsp.