Managing Serviceguard 12th Edition, March 2006

Planning and Documenting an HA Cluster
Package Configuration Planning
Chapter 4 173
However, if the package halt script fails with “exit 1”,
Serviceguard does not halt the node, but sets
NO_RESTART for the package, which causes package
switching (AUTO_RUN) to be disabled, thereby
preventing the package from starting on any adoptive
node.
Controlscript pathname Serviceguard Manager will automatically
create and maintain a control script if you use Guided
Mode, the Serviceguard Manager default. If you
choose, you can edit the control script yourself, and
name your own path. Once you leave Guided Mode,
however, Serviceguard Manager cannot update your
script.
Enter the full pathname of the package control script.
(The script must reside in a directory that contains the
string “cmcluster.”) Ensure that this script is
executable. In the ASCII package configuration file,
this parameter maps to the two separate parameters
named RUN_SCRIPT and HALT_SCRIPT.
It is recommended that you use the same script as both
the run and halt script. This script will contain both
your package run instructions and your package halt
instructions. If you wish to separate the package run
instructions and package halt instructions into
separate scripts, the package configuration file allows
allows you to do this by naming two separate scripts.
However, under most conditions, it is simpler to use
the name of the single control script as the name of the
RUN_SCRIPT and the HALT_SCRIPT in the ASCII file.
When the package starts, its run script is executed and
passed the parameter ‘start’; similarly, at package halt
time, the halt script is executed and passed the
parameter ‘stop’.
If you choose to write separate package run and halt
scripts, be sure to include identical configuration
information (such as node names, IP addresses, etc.) in
both scripts.