Managing Serviceguard 13th Edition, February 2007

Cluster and Package Maintenance
Managing Packages and Services
Chapter 7320
Using Serviceguard Commands to Halt a Package
Use the cmhaltpkg command to halt a package, as follows:
# cmhaltpkg pkg1
This halts pkg1. If pkg1 is a failover package, it will also disables it from
switching to another node.
Before halting a package, it is a good idea to use the cmviewcl command
to check for package dependencies. You cannot halt a package unless all
packages that depend on it are down. If you try, Serviceguard will take
no action, except to send a message indicating that not all dependent
packages are down. Before you halt a system multi-node package, or halt
all instances of a multi-node package, halt any packages that depend on
them.
Moving a Failover Package
You can use Serviceguard Manager, or Serviceguard commands as shown
below, to move a failover package from one node to another.
Using Serviceguard Commands to Move a Running Failover
Package
Before you move a failover package to a new node, it is a good idea to use
the cmviewcl -v -l package command and look at dependencies. If the
package has dependencies, be sure they can be met on the new node.
To move the package, you first halt it where it is running using the
cmhaltpkg command. This action not only halts the package, but also
disables switching the package back to the node on which it halts.
After it halts, you run the package on the new node using the cmrunpkg
command. Then re-enable switching. cmmodpkg can be used with the -n
option to enable a package to run on a node if the package has been
disabled from running on that node due to some sort of error. If no node
is specified, the node the command is run on is the implied node.
Example:
# cmhaltpkg pkg1
# cmrunpkg -n ftsys10 pkg1
# cmmodpkg -e pkg1