4.0.0 HP Polyserve Matrix Server Administration Guide (T5392-96052, March 2010)

When a monitor is instantiated for a device (because the ClusterPulse process is
starting or the configuration has changed), Matrix Server selects the best server to
make the device active. The Start script is run on this server. The Stop script is run
on all other servers configured for the monitor to ensure that the device is not active
on those servers.
Start scripts must be robust enough to run when the device is already started, without
considering this to be an error. Similarly, Stop scripts must be robust enough to run
when the device is already stopped, without considering this to be an error. In both
of these cases, the script should exit with a zero exit status.
This behavior is necessary because Matrix Server runs the Start and Stop scripts to
establish the desired start/stop activity, even though the device may actually have
been started by something other than Matrix Server before the ClusterPulse process
was started.
The Start and Stop scripts must also handle recovery from events that may cause them
to run unsuccessfully. For example, if the system runs out of swap space while running
a Start script, the script will fail and exit non-zero. The device could then become
active on another server, causing the Stop script to run on the original server even
though the Start script did not complete successfully.
To configure scripts from the command line, use these options:
--recoveryScript <script>
--startScript <script>
--stopScript <script>
Use custom scripts to modify start/stop activities
Some built-in monitors perform starting or stopping activities. If you need to take an
action before or after the starting or stopping activity, you can create a Start or Stop
script for the action and specify it on the Scripts tab for the monitor. (Currently, only
the SQL Server and CIFS monitors have starting or stopping activities.)
The default order for starting is:
• Run the monitor’s starting mechanism (if any)
• Run the custom Start script (if any)
If you want to reverse this order, preface the Start script with the prefix [pre] on
the Scripts tab.
The default order for stopping is:
• Run the custom Stop script (if any)
• Run the monitor’s stopping mechanism (if any)
HP PolyServe Matrix Server administration guide 227