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

cmrunserv(1m)							 cmrunserv(1m)

NAME
       cmrunserv - run a service from the high availability package run script

SYNOPSIS
       cmrunserv [-v] service_name service_command_string
       cmrunserv [-v] [-r restarts] service_name service_command_string
       cmrunserv [-v] [-R] service_name service_command_string

DESCRIPTION
       cmrunserv  is used in the high availability package run script to run a
       service.

       To start package's service, 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 (1m) or cmmakepkg (1m).

       If the service process dies, cmrunserv updates the status of  the  ser‐
       vice to down.  The cluster software will recognize the change in status
       and execute the normal package recovery sequence.  This	includes  exe‐
       cuting  the  package halt script, determining if the package can be run
       on a different node, and, if so, executing the package  run  script  on
       the new node.

       Should  the  service_command  be	 halted	 by  the cmhaltserv command, a
       SIGTERM signal will be sent to the process.  This executable  or	 shell
       script should be able to handle a SIGTERM signal and execute a graceful
       shutdown performing any cleanup necessary.  If the process ignores  the
       SIGTERM,	 a SIGKILL will be sent to the process.	 If a SIGKILL is sent,
       the process will die immediately and will  be  unable  to  perform  any
       cleanup.

   Options
       cmrunserv supports the following options.

	      -v	Verbose output will be displayed.

	      -r restarts
			Indicates  that	 the  service  should be automatically
			restarted by the cluster software if it fails, without
			halting the package. restarts indicates how many times
			the service may fail  before  the  package  should  be
			halted.

	      -R	Indicates the service should be restarted an unlimited
			number of times if it fails.

	      service_name
			Name of the service as it exists in the	 package  con‐
			figuration information.

	      service_command_string
			Process	 string	 to  be	 started.   This  includes the
			process name  and  any	arguments  necessary  for  the
			process	 to  run.    The  process  name must be a full
			path, may be either a command name or a shell  script,
			and must be executable.

RETURN VALUE
       cmrunserv returns the following values:

	       0   Successful completion.
	       1   Command failed.

EXAMPLES
       To  run the service command string /var/opt/db/database1 under the ser‐
       vice name db1, do the following:

	      # Run the process /var/opt/db/database1
	      cmrunserv db1 /var/opt/db/database1

       This line should only be executed within a package run script.

AUTHOR
       cmrunserv was developed by HP.

SEE ALSO
       cmhaltserv(1m), cmquerycl(1m), cmmakepkg(1m), cmmodnet(1m).

		    Requires Optional Serviceguard Software	 cmrunserv(1m)

Vote for polarhome