Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

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 configura‐
       tion 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 relationships, 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 place‐
			ment  without affecting the current state of the nodes
			or packages. This option validates the	node's	eligi‐
			bility	with  respect  to  the package dependencies as
			well  as  the  external	 dependencies  such   as   EMS
			resources,  package  subnets,  and storage before pre‐
			dicting any package placement decisions. If there is a
			package 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)

Vote for polarhome