Managing Serviceguard Seventeenth Edition, First Reprint December 2009

Starting the Special-Purpose CVM and CFS Packages
Use CFS administration commands to start the special-purpose multi-node packages
used with CFS. For example, to start the special-purpose multi-node package for the
disk group package (SG-CFS-DG-id#), use the cfsdgadm command. To start the
special-purpose multi-node package for the mount package (SG-CFS-MP-id#) use
the cfsmntadm command. Check to see if your package has a dependency; before you
can start your dependent package, you must start all the packages it depends on.
Halting a Package
You halt a Serviceguard package when you want to bring the package out of use but
want the node to continue running in the cluster. You can halt a package using
Serviceguard Manager or on the Serviceguard command line.
Halting a package has a different effect from halting the node. When you halt the node,
its failover packages may switch to adoptive nodes (assuming that switching is enabled
for them); when you halt a failover package, it is disabled from switching to another
node, and must be restarted manually on another node or on the same node.
System multi-node packages run on all cluster nodes simultaneously; halting these
packages stops them running on all nodes. A multi-node package can run on several
nodes simultaneously; you can halt it on all the nodes it is running on, or you can
specify individual nodes.
Halting a Package that Has Dependencies
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 the packages that depend on it are down. If you
try, you’ll see a Serviceguard message telling you why the operation failed, and the
package will remain up.
If this happens, you can repeat the halt command, this time including the dependent
package(s); Serviceguard will halt all the packages in the correct order. First, use
cmviewcl to be sure that no other running package has a dependency on any of the
packages you are halting.
You can use Serviceguard Manager, or Serviceguard commands as shown below, to
halt a package.
Using Serviceguard Commands to Halt a Package
Use the cmhaltpkg command to halt a package, as follows:
cmhaltpkg pkg1
This halts pkg1, and, if pkg1 is a failover package, also disables it from switching to
another node.
316 Cluster and Package Maintenance