cmhaltnode(1m) [hpux man page]
cmhaltnode(1m) cmhaltnode(1m) NAME
cmhaltnode - halt a node in a high availability cluster SYNOPSIS
cmhaltnode [-f] [-v] [-t] [node_name...] DESCRIPTION
cmhaltnode causes a node to halt its cluster daemon and remove itself from the existing cluster. To halt cluster on the node, a user must either be superuser(UID=0), or have an access policy of FULL_ADMIN allowed in the cluster configu- ration file. See access policy in cmquerycl. When cmhaltnode is run on a node, the cluster daemon is halted and, optionally, all packages that were running on that node are moved to other nodes if possible. If node_name is not specified, the cluster daemon running on the local node will be halted and removed from the existing cluster. If you issue this command while a cluster is still in the process of forming, the command will fail with the message "Unable to connect to daemon." If this happens, wait for the cluster to form successfully, then issue the command again. Options cmhaltnode supports the following options: -f Force the node to halt even if there are packages or group members running on it. The group members on the node will be terminated. The halt scripts for all packages running on the node will be run; based on priority or dependency relation- ships, this may affect packages on other nodes. In other words, packages on other nodes may either start or halt based on this package halting. If the package configuration and current cluster membership permit, and if the package halt script succeeds, the packages will be started on other nodes. Without this option, if packages are running on the given node, the command will fail. If a package fails to halt, the node halt will also fail. -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 packages. 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. If there is a pack- age in maintenance mode running on the nodes being halted, the package will always be halted and not failover to another node; the report will not display an assessment for that package. node_name... The name of the node(s) to halt. RETURN VALUE
cmhaltnode returns the following value: 0 Successful completion. 1 Command failed. EXAMPLES
Halt the cluster daemon on two other nodes: cmhaltnode node2 node3 AUTHOR
cmhaltnode was developed by HP. SEE ALSO
cmquerycl(1m), cmhaltcl(1m), cmruncl(1m), cmrunnode(1m), cmviewcl(1m), cmeval(1m). Requires Optional Serviceguard Software cmhaltnode(1m)
Check Out this Related Man Page
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)