Using ClusterCATS Previous Up One Level Next Index Home Search
Installing ClusterCATS


Installing ClusterCATS

ClusterCATS is a separate installation package from the JRun server installation program. You must install the ClusterCATS load-balancing and high-availability software on each servers in your cluster. You can run the installation program to install ClusterCATS on a separate, nonclustered computer from which you will administer your clusters with ClusterCATS Explorer (Windows).

Before installing ClusterCATS on a platform, review the pre-installation steps described in "Before you install".

This section describes the following:

Installing ClusterCATS on Windows

ClusterCATS supports the Microsoft Internet Information Server (IIS) 4.0 and Netscape/iPlanet Enterprise Server on Windows NT 4.0 (with Service Pack 4 or later) and IIS 5.0 on Windows 2000 and Windows .NET Server.

To install ClusterCATS on Windows servers:

  1. Run the ClusterCATS setup.exe file from Windows Explorer or the Run dialog box.
  2. Accept the default installation directory, or click Browse to select a different directory and click Next. In this manual, the installation directory is referred to as <CC_install_directory>.
  3. Use the following table to determine which components to install. For more information, see "ClusterCATS components".
    Component
    Reason to Select Component
    ClusterCATS Explorer
    To use this computer to administer other ClusterCATS Servers in your clusters. This computer can also be a member of the cluster with the ClusterCATS Server component.
    ClusterCATS Server
    If you are adding this computer as a member of a cluster. This component includes the Server Administrator.
    Documentation
    To make ClusterCATS documentation accessible from this computer.

    If more than one of the supported web servers is running, the Select Web Server dialog box appears.

  4. Select the web server to which you want ClusterCATS to bind. ClusterCATS does not support clustering different types of web servers on one computer.
  5. Select a method of load management.

    Note:   You must select JRun (JSP) Performance to have ClusterCATS manage the JRun server load.

    The following table describes your options:
    Method
    Reason to Select Option
    HyperText Transport Protocol (HTTP)
    To have ClusterCATS load manage just your web server's HTTP requests.
    JRun (JSP)
    To have ClusterCATS load manage your JRun server's JSP and servlet requests.
    ColdFusion (CFM)
    To have ClusterCATS load manage your ColdFusion server's CFML page requests. You must have ColdFusion Server installed for this option to take effect.

  6. In the Server Fail-Over dialog box, to enable this server to assume the IP address of a failed server, click Yes. To prevent this computer from assuming a failed server's IP address, click No.

    Note:   If you use Cisco LocalDirector with ClusterCATS, select No for server failover. If ClusterCATS performs dynamic IP addressing, the LocalDirector will not be able to recover the failed-over IP address.

    For more information, see "Using Server Failover".

  7. You are prompted to open ClusterCATS Explorer right away. By doing so, you can add the new server to a cluster or create a cluster. If you are going to use this server as the administration computer, you are not required to add it to a cluster.

Installing ClusterCATS on UNIX

To install ClusterCATS on UNIX, you must have the following information:

Note:   The procedures in this section assume you have installed JRun.

ClusterCATS supports the Apache Web Server and the Netscape Enterprise Server on Solaris platforms, and the Apache Web Server on Linux.

For more information about installation options, enter ? at any prompt during the installation procedure. Default selections appear in brackets [default].

To install ClusterCATS on UNIX:

  1. Enter the following command as root:
    ./cluster_install

    The ClusterCATS installation welcome message appears.

    Do you wish to continue with this installation? [yes]?
  2. Enter Yes to continue with the installation or No to exit the installation.

    The license agreement confirmation message appears.

    Do you agree to the license terms? [no]?
  3. Review the license.txt file that is supplied with ClusterCATS. If you agree with the licensing terms, enter Yes at the prompt. If you do not agree with the licensing terms, enter No. Entering No terminates the installation procedure.

    The installation directory prompt appears.

    Enter install directory for ClusterCATS Server: [/opt]:
  4. Enter the base directory where ClusterCATS will be installed, or press Enter to accept the default. The installation creates a ./btcats subdirectory under the base directory.

    Note:   The base directory (such as /opt) must exist prior to the installation.

    The installation continues with the Configure Web Server Specific Information section.

    If you are installing ClusterCATS on Linux, skip to the next step.

    If you are installing ClusterCATS on Solaris, you are prompted to enter the type of web server to bind ClusterCATS to:

    Enter Web Server type (Netscape, Apache, or <cr> to continue):
  5. On Solaris, enter your web server type. On Linux, continue with the Apache instructions in this step.

    Apache: You are prompted to enter Apache's installation directory and then the location of the Apache config file:

    Enter Apache installation directory: [/usr/local/apache]:

Enter location of Apache config file httpd.conf: [/usr/local/apache/conf]:

    Netscape: You are prompted to enter the location of Netscape's root directory:

    Enter Netscape Enterprise Server Root: [/usr/netscape/suitespot/https-server]:
  6. Enter the configuration file location. ClusterCATS prompts you to optimize load balancing for this server:
    Optimize load balancing for either HTTP or JRun on https-<yourserver> [HTTP]:

    ClusterCATS prompts you for the JRun installation directory:

    Enter install directory for JRun []:
  7. Enter the directory. ClusterCATS prompts you to turn on failure monitoring:
    Monitor Web Server for Failures? [yes]?
  8. Enter Yes to have monitoring turned on for this server. Enter No to disable monitoring.

    ClusterCATS optionally supports monitoring and restarting the web server on server failure. Failures include the server not running or not responding to HTTP requests.

    ClusterCATS prompts you to enable server failover on this server:

    Enable ClusterCATS Server instance for Failover? [yes]?
  9. Enter Yes to enable this server to assume the IP addresses for a failed cluster member, and to pick up all the HTTP traffic originally addressed to the failed server. Enter No to skip failover support for this server.

    For more information, see "Using Server Failover".

    If you are configuring ClusterCATS with Netscape and selected Yes, you are prompted to decide which servers in the cluster this server will provide failover support for:

    Cluster Mates to provide Failover for: all, subset, none [all]:
  10. Netscape only: Enter all to provide failover support to all members of this server's cluster. Enter subset to explicitly define the cluster members for which this server will provide failover support. Enter none to disable server failover.

    If you entered subset, you are prompted to enter a list of the ClusterCATS Server Members that are allowed to fail over to this server. For more information, see the online help.

  11. Restart your web server for the changes to take effect.
Copyright © 2002, Macromedia Inc. All rights reserved. Previous Up Next Index Home Search

Comments