Installing ClusterCATS

ClusterCATS is an embedded installation option in the ColdFusion Server installation program. To install the ClusterCATS load balancing and high availability capabilities on each of your servers, run the ColdFusion Server installation program on each server that will be part of your cluster and choose the Load Balancing and High Availability install option. Also, run the installation program to install ClusterCATS on a separate, non-clustered machine from which you will administer your clusters using the ClusterCATS Explorer.

Note To install ClusterCATS on Windows NT servers:
  1. Insert the ColdFusion Server v4.5 CD into your CD drive or access it from your network jukebox (Enterprise users).
  2. Click Start>Run to display the Run dialog box.

  3. Enter the path location for where the ColdFusion Setup.exe resides or click Browse to drill down to it.
  4. Click OK.

    The ColdFusion v4.5 Setup program starts and displays the ColdFusion Setup Welcome page.

  5. Click Next in the Welcome and Software License Agreement dialog boxes.

    The User Information dialog box appears after the Software License Agreement dialog box.

  6. Enter your name, company, and ColdFusion serial number in the User Information dialog box and click Next.
    Note You'll find your ColdFusion serial number on the product box.

    The Choose Destination Directory dialog box appears next.

  7. Accept or change the default destination folder and click Next.

    The Select Web Server dialog box appears.

    If your Web server is already installed, the ColdFusion Setup program will automatically detect it.

  8. If your Web server is not one of the ones listed, select the Other option and click Next. Otherwise, just click Next.

    The Select Web Server Document Directory dialog box appears next.

  9. Either accept the Web server's default document directory or enter a different location for the default directory and click Next.
    Note ColdFusion documentation and example code are installed in a subdirectory below the Web server's document directory.

    The Select Install Options dialog box appears.

  10. If you've already installed ColdFusion and just want to install ClusterCATS, deselect all of the options you don't want, leave the Load Balancing and High Availability check box selected, and click Next.

    The Server High Availability dialog box appears.

  11. Leave the Yes option selected if you want ClusterCATS to provide transparent failover support for your clusters and click Next.

    This option ensures that the server is able to assume both the IP address of a failed server and any HTTP requests originally sent to the failed server.

  12. Click Next or OK in the remaining dialog boxes to begin copying the ClusterCATS files to the server.
  13. Click Finish to complete the installation.
Note To install ClusterCATS on Sun Solaris servers:
  1. Log in as root.
  2. Load the ColdFusion CD-ROM into your CD drive.
  3. Mount the CD-ROM on /cdrom/cdrom0 if necessary.

    If the Solaris Volume Manager is active, you won't need to mount the CD.

  4. Type pkgadd -d /cdrom/cdrom0 to start the installation process.
  5. Enter cfusion at the prompt and press Enter to select the ColdFusion package. Alternatively, you can just press Enter to accept the default (All), as ColdFusion is the only package available.
  6. Enter the ColdFusion registration ID (serial number) when prompted.

    You'll find your ColdFusion registration ID on the product box.

  7. Enter the name of the directory in which you want to install ColdFusion or accept the default directory.

    /opt is the default installation directory.

  8. Enter the name of the Web server you are running and press Enter or just press Enter if you are running the default Web server (Netscape Enterprise Server).
  9. Press Enter to have the installation program automatically configure the Web server.

    The program loads the necessary plug-in for Netscape or module for Apache 1.3.x Web servers.

  10. When prompted with whether or not to install ClusterCATS, press Enter to do so.
  11. If you want the server on which you are installing ClusterCATS to be able to assume the IP address and HTTP traffic of a failed server in the cluster, press Enter to configure this server with failover services. Otherwise, enter n and press Enter.

    Typically, you want all of the servers in your cluster to be configured for failover, particularly if they have the same processing capacity. However, if you have a mixed server environment with some high capacity servers and several lower capacity servers, you may not want the less powerful machines to accept the additional load of unavailable servers in the cluster.

  12. Enter your Web server's document root directory and press Enter.

    The default document root directory is /docroot.

  13. Do not install Advanced Security at this time; enter n when prompted and press Enter.
  14. Enter the password you want to use to access the ColdFusion Administrator, which allows you to configure and modify settings for the ColdFusion Server.

    You'll be asked to re-enter the password for verification purposes.

  15. Enter the password you want to use to access ColdFusion's Remote Development Services (RDS), which allows you to connect to ColdFusion Server when developing applications with ColdFusion Studio.

    You'll be asked to re-enter the password for verification purposes.

  16. Install the ColdFusion documentation.

    The documentation is installed in the /cfdocs directory, which resides under the Web root directory (/docroot).

  17. Enter the user name under which ColdFusion will run or press Enter to run under the default user name (nobody).
  18. Press Enter to begin the installation.

When the installation is complete, a shell script restarts the Web server and starts ColdFusion services.

Note To install ClusterCATS on Linux servers:
  1. Log in as root.
  2. Load the ColdFusion CD-ROM into your CD drive.
  3. Mount the CD-ROM on /mnt/cdrom if necessary.
  4. Change directories to the cf/linux directory on the CD.
    Note This procedure assumes you have already installed ColdFusion Server and now want to install ClusterCATS. If you need to install ColdFusion on Linux first before installing ClusterCATS, see "Installing ColdFusion on Linux".

  5. Run the ClusterCATS installation script by entering the following command:

    ./cluster_install

    The ClusterCATS installation script starts.

  6. Enter the directory in which you want to install ClusterCATS and press Enter.
    Note The default directory (/opt/coldfusion/btcats) assumes you've already installed ColdFusion to the default directory (/opt). If you've installed ColdFusion to a directory other than the default, be sure to specify that directory path instead.

  7. Either accept the default path for where your Web server resides or provide a different path and press Enter.

    The default path is /usr/sbin/httpd.

  8. Either accept the default path for where your Web server's configuration file (httpd.conf) resides or provide a different location and press Enter.

    The default location is /etc/httpd/conf.

  9. Press Enter to have ClusterCATS monitor all cluster members (servers) for failures.
  10. If you want ClusterCATS to monitor the Web server for failures as well, press Enter. Otherwise, enter n and press Enter.
  11. If you want the server on which you are installing ClusterCATS to be able to assume the IP address and HTTP traffic of a failed server in the cluster, press Enter to configure this server with failover services. Otherwise, enter n and press Enter.

    Typically, you want all of the servers in your cluster to be configured for failover, particularly if they have the same processing capacity. However, if you have a mixed server environment with some high capacity servers and several lower capacity servers, you may not want the less powerful machines to accept the additional load of unavailable servers in the cluster.

  12. Press Enter to have the ClusterCATS installation script begin installing the necessary program files and making the configurations you specified.

    Once the ClusterCATS installation script finishes, you are returned to the command prompt. You are now ready to begin creating clusters.