Managing Serviceguard 11th Edition, Version A.11.16, Second Printing June 2004

Understanding Serviceguard Software Components
How Package Control Scripts Work
Chapter 3 91
When a Package is Halted with a Command
The Serviceguard cmhaltpkg command has the effect of executing the
package halt script, which halts the services that are running for a
specific package. This provides a graceful shutdown of the package that
is followed by disabling automatic package startup (AUTO_RUN).
NOTE If the cmhaltpkg command is issued with the -n <nodename> option,
then the package is halted only if it is running on that node.
The cmmodpkg command cannot be used to halt a package, but it can
disable switching either on particular nodes or on all nodes. A package
can continue running when its switching has been disabled, but it will
not be able to start on other nodes if it stops running on its current node.
During Halt Script Execution
Once the package manager has detected a service failure, or when the
cmhaltpkg command has been issued for a particular package, then it
launches the halt script (that is, the control script executed with the
‘halt’ parameter. This script carries out the following steps (also shown
in Figure 3-15):
1. Halts any deferred resources that had been started earlier.
2. Halts all package services.
3. Executes any customer-defined halt commands.
4. Removes package IP addresses from the LAN card on the node.
5. Unmounts file systems.
6. Deactivates volume groups.
7. Exits with an exit code of zero (0).