MACROMEDIA COLDFUSION MX-CLUSTERCATS, Use Manual

Page: 92 / 156

82 Chapter 4 Configuring Clusters
9 To create a new probe, click New.
The ColdFusion Application Probe page appears. If this is the first probe for this
server or you clicked New to add another probe, the ColdFusion Application Probe
page appears.
10 Configure the application probe settings as described in the following table:
Field Description
Status This is an informational field. If the probe is not registered, the
Status displays
Not registered . If the probe is registered, the
Status displays Succeeding .
Pathname Enter the path to the ColdFusion probe. Do not change the default
selection unless you installed ClusterCATS for ColdFusion to a
directory other than the default installation directory.
Working directory Enter the path to the probe’s working directory. Do not change the
default selection unless you installed ClusterCATS for ColdFusion
to a directory other than the default installation directory.
Startup Parameters Enter the actual URL of the site you want the probe to access
followed by a text string that appears on a page within the site you
are probing (cfprobe.cfm in the screen shown in step 9.)
Note: Do not modify the RESTART explicit parameter if you want
the probe to automatically restart the ColdFusion Server upon
detecting a failure. However, if you do not want ClusterCATS to
automatically restart the ColdFusion Server upon detecting a
failure, replace RESTART with NORESTART.
Timeout (sec) Enter a time, in seconds, to indicate how long ClusterCATS should
wait before a ColdFusion server failure is registered.
Do not set this value to less than 60 seconds because
ClusterCATS might restart the ColdFusion server inadvertently
(due to network congestion, for example), rather than detect an
actual failure on the ColdFusion server.
Frequency (sec) Enter a time, in seconds, to indicate how often the probe checks
the ColdFusion server.
Probes that restart web applications should be configured to run
no more frequently than the time it takes to stop and restart
ColdFusion. This time is highly site-specific, because it depends
on the system resources available on the servers and the volume
of traffic at the site.
For probes that do not restart the web application, the Frequency
depends on how long you can reasonably afford to have your web
application off-line. A minimum Frequency of 15 seconds is
recommended.
Return value Enter 0 so that the probe succeeds on a successful probing of the
page. Enter a non-zero number to have the probe succeed on a
failure.
The default is 0. Only under rare circumstances would you change
this to a non-zero number.