home / support Icon or Spacer
Icon or Spacer Macromedia ClusterCATS Release Notes
ClusterCATS 5.1 for Macromedia JRun® 4 and Macromedia ColdFusion® MX

Last Updated August 19, 2002

These release notes contain last-minute issues related to ClusterCATS and ClusterCATS installation:

Last-minute issues

Accessing ClusterCATS tech notes

To see a list of tech notes, articles, and software patches for ClusterCATS, go to, select ClusterCATS and Server Monitoring, and click Search. Do not download and install any pre-5.1 patches onto your ClusterCATS 5.1 cluster.

ClusterCATS components

The table on page 4 of Using ClusterCATS indicates that you can use the Windows-based Server Administrator to administer a UNIX cluster. The Windows-based Server Administrator does not drive UNIX. You can, instead, remotely administer a UNIX-based cluster using the Windows-based ClusterCATS Explorer. You can load the explorer on any Windows client.

Supported web servers

ClusterCATS supports the following web servers:

  • Linux: Apache 1.3.x
  • Solaris: NES 3.0 and 4.0 and Apache 1.3.x
  • Windows: IIS 5.0, IIS 4.0, NES 4.0


Installation and configuration issues Windows system requirements

ClusterCATS runs on server operating systems only. It does not run on Windows NT Workstation, Windows 2000 Professional, or Windows XP Professional.

Netscape troubleshooting

When using the ClusterCATS Web Explorer (btweb) with the Netscape Enterprise Server, start the Netscape Admin server before launching btweb.

DNS considerations

Do not install ClusterCATS on a computer that your networks uses as a DNS server or domain controller.

Before installing ClusterCATS, be sure that your network's DNS name resolution is properly configured and that all web servers are functioning.

Install the application server before installing ClusterCATS

You must install ColdFusion MX or JRun 4 before installing ClusterCATS. Additionally, for a JRun installation, you must run the Web Server Configuration Tool before installing ClusterCATS.

Web server specification

The web server and version specified during the ClusterCATS install must match the web server and version chosen during ColdFusion MX installation or when running the Web Server Configuration Tool (JRun).

Configuring wsprobe on Linux Apache

The ClusterCATS web server probe (wsprobe) on Linux Apache is written to restart /bin/apachectl. However, the Apache server bundled with RedHat 7.x is installed by default in /etc/init.d/httpd. To enable wsprobe to restart various installations of Apache, you must modify certain scripts. The following procedure explains the modifications you must make to enable ClusterCATS to restart the default Apache server bundled with RedHat 7.x:

  1. Open /usr/lib/btcats/scripts/btadmin in a text editor and replace references to /bin/apachectl with httpd.
  2. Make the same changes in the /usr/lib/btcats/scripts/bt-stop-server and /usr/lib/btcats/scripts/bt-start-server scripts.
  3. Open /usr/lib/btcats/database/btinstall.config in a text editor and change BT_HTTPD and BT_NSDIR, as follows:
    BT_HTTPD = /etc/init.d/httpd
    BT_NSDIR = /etc/init.d
  4. Go to the /usr/lib/btcats/scripts directory and run ./btadmin stop, which stops ClusterCATS and Apache.
  5. Run ./btadmin start, which starts ClusterCATS and Apache.

    If either of these commands generate errors, review your changes in the modified files.

ColdFusion MX notes

Consider the following when using ClusterCATS with ColdFusion MX:

  • ClusterCATS supports Netscape web servers versions 3.x and 4.x. If you want to use one of these web server versions, you should make sure that Netscape iPlanet 6.x isn't installed on the same server when installing ColdFusion MX (the ColdFusion MX install only offers the latest version of each web server).
  • ClusterCATS does not run with CFMX Professional. In order to use ClusterCATS with ColdFusion MX, you must use CFMX Enterprise.
  • The CFAM Server Monitor Agent is deprecated. However, ClusterCATS has a built in dfp agent for communication with Cisco Local Director. ClusterCATS can also be used without load balancing enabled (in the passive-mode) for its probes, alarms and reporting capabilities.
JRun 4 notes

Consider the following when using ClusterCATS with JRun 4:

  • By default, ClusterCATS monitors the default JRun server, which must be running as a service. Additionally, the service must be named Macromedia JRun Default Service. For information on defining a JRun server as a Windows service, see Installing JRun. For information on using ClusterCATS with additional JRun servers, see Using ClusterCATS.
  • ClusterCATS does not run with the JRun Developer edition.
  • When using ClusterCATS with the Netscape web server, if the web server can't communicate with the JRun server and the Netscape logs/errors file contains a message similar to "Couldn't initialize from remote server, JRun server(s) probably down," restart Netscape after the JRun default web server is started.