cmhaltpkg(1m)															     cmhaltpkg(1m)

NAME

       cmhaltpkg - halt a high availability package

SYNOPSIS

       cmhaltpkg [-v] [-t] [-n node_name]...  package_name...

       cmhaltpkg [-v] [-s] [-n node_name]...  package_name...

DESCRIPTION

       cmhaltpkg connects to the Serviceguard cluster manager and halts the specified package(s) or multi-node package instance(s).

       When a package or package instance is halted, global switching (AUTO_RUN) is disabled for that package.

       cmhaltpkg may be run on any node within the cluster and may operate on any package within the cluster.

       To  halt  a  package,  a  user must either be a superuser with effective user ID of zero (see id(1) and su(1)), or have an access policy of
       PACKAGE_ADMIN allowed in the cluster or package configuration file. See access policy in cmquerycl(1m) or cmmakepkg(1m).

       If no node_name arguments are supplied, each package will be halted on any and all nodes where it is running. If the package is not running
       on any nodes, the command will fail.

       cmhaltpkg should not be used to halt SYSTEM_MULTI_NODE packages (HP-UX only). Use cmhaltnode or cmhaltcl to halt SYSTEM_MULTI_NODE packages
       instead. Packages of other types may be halted on a subset of the configured nodes by specifying one or more node_name arguments.

       cmhaltpkg will fail if each specified package is not running on all the specified nodes.

       Packages are halted in the order required by their configured dependencies. Packages without configured	dependencies  are  halted  in  the
       order  specified  on the command line.  To successfully halt a package, all required dependent packages must either be previously halted or
       specified as a package_name argument in the cmhaltpkg command.  Packages configured with STORAGE_GROUP are implicitly dependent on the cor-
       responding multi-node cluster volume manager (CVM) package. (HP-UX only)

       cmhaltpkg validates its command line prior to halting any package and returns an error if the user does not have correct access to complete
       the operation or if illegal combinations of node_name and package_name arguments are encountered.

       If a problem is detected while halting a package, cmhaltpkg exits with an error indication and remaining  package_name  arguments  are  not
       processed.

       A  package  in  maintenance mode that was start up to and including a specified module can be halted from that specified module. Only those
       modules which were started are halted.

   Options
       cmhaltpkg supports the following options:

	      -n node_name   Acts only on a specific node.  If the package is not running on the specified node, it will not be halted.

	      -v	     Verbose output will be displayed.

	      -t	     Test only. Provide an assessment of the package placement without affecting the current state of the nodes  or  pack-
			     ages.  This  option validates the node's eligibility with respect to the package dependencies as well as the external
			     dependencies such as EMS resources, package subnets, and storage before predicting any package  placement	decisions.
			     This option is not legal for package in maintenance mode.

	      -s	     Symmetric	halt  is only for packages in maintenance mode.  If a package in maintenance mode has been started up to a
			     module as specified by cmrunpkg -m, then cmhaltpkg -s will halt the package up to that module.  Otherwise,  cmhaltpkg
			     -s will halt the package for all the modules specified in its configuration file.

RETURN VALUE

       cmhaltpkg returns the following value:

	      0    Successful completion.
	      1    Command failed.
	      2    Command failed due to a transient condition.

EXAMPLES

       A  sequence  of	cmhaltpkg  and	cmrunpkg commands may be used to move a package from one node to another.  For example, the package may be
       halted on one node and then run on a new node, provided that the package is enabled for the new node.

       To move package package1 to node node2, do the following:

	      cmhaltpkg package1

	      cmrunpkg -n node2 package1

	      cmmodpkg -e package1 (to enable package switching, if desired)

AUTHOR

       cmhaltpkg was developed by HP.

SEE ALSO

       cmmakepkg(1m), cmquerycl(1m), cmmodpkg(1m), cmrunpkg(1m), cmviewcl(1m), cmeval(1m).

						      Requires Optional Serviceguard Software					     cmhaltpkg(1m)