Installing WebSphere Application Server web components

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.
See the IBM Support article: http://www-01.ibm.com/support/docview.wss?uid=swg21634430, and http://www.ibm.com/support/docview.wss?uid=swg21572830 for more detailed, information about the installation and upgraded tasks:
  • Matrix of supported installation, upgrade, and roll back scenarios
  • Information about upgrading an existing installation of WebSphere Application Server, and IBM HTTP Server components.
  • Instructions for upgrading ClearCase and ClearQuest Web components, deploying, or redeploying them to the WebSphere Application Server

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.

Procedure

To install WebSphere Application Server components:

  1. Launch Installation Manager.
  2. Select File > Preferences, 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.
  3. Click Install on the main Installation Manager screen.
  4. 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)
  5. 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.
  6. 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.

  7. Accept the license agreement, and click Next.
  8. On the Shared Resources Directory panel, review any installation warnings and instructions.
  9. 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.
  10. Select your translation choices, and click Next.
  11. 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.
  12. On the Configuration for IBM HTTP Server panel, specify your web server configuration.
  13. 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.
  14. 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.
  15. 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.
  16. 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.
  17. 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: All Programs > IBM WebSphere > WebSphere Customization Toolbox V8.0 > Tools > WebSphere Plug-ins Configuration Tool.

Results

The WebSphere Customization Toolbox opens.

What to do next

The post-installation steps to complete the plug-in configuration include:

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.


Feedback