Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
HASTMON(8)		    System Manager's Manual		    HASTMON(8)

NAME
       hastmon -- cluster monitoring daemon

SYNOPSIS
       hastmon [-dFh] [-c config] [-P pidfile]

DESCRIPTION
       The  hastmon  daemon  monitors a	resource (process, FS, etc) on several
       nodes.  The resource can	be active only on one machine. This machine is
       called primary.

       There is	one main hastmon daemon	which starts  new  worker  process  as
       soon as a role for the given resource is	changed	to primary or watchdog
       or as soon as a role for	the given resource is changed to secondary and
       remote  (primary)  node	will successfully connect to it.  Every	worker
       process gets a new process title	(see setproctitle(3)), which describes
       its role	and resource it	controls.  The exact format is:

	     hastmon: <resource	name> (<role>)

       The connection between two hastmon daemons is initiated	from  the  one
       running	as  primary  to	 the  one  running as secondary.  When primary
       hastmon is unable to connect or connection fails, it will try to	re-es-
       tablish connection every	few seconds.

       On start	the hastmon daemon does	not pick its  role  up	automatically.
       The  role  has  to  be  configured with the hastctl(8) control utility.
       Secondary can switch its	role to	primary	if  the	 following  conditions
       are  meat: there	is no connection from primary and there	are complaints
       from watchdog.

       The hastmon daemon can be started with the following command line argu-
       ments:

       -c config   Specify alternative location	 of  the  configuration	 file.
		   The default location	is /usr/local/etc/hastmon.conf.

       -d	   Print  or  log  debugging  information.  This option	can be
		   specified multiple times to raise the verbosity level.

       -F	   Start the hastmon daemon in	the  foreground.   By  default
		   hastmon starts in the background.

       -h	   Print the hastmon usage message.

       -P pidfile  Specify  alternative	 location of a file where main process
		   PID	 will	be   stored.	The   default	location    is
		   /var/run/hastmon.pid.

FILES
       /usr/local/etc/hastmon.conf
			    The	   configuration    file   for	 hastmon   and
			    hastmonctl(8).
       /var/run/hastmonctl  Control socket used	by the	hastmonctl(8)  control
			    utility to communicate with	hastmon.
       /var/run/hastmon.pid
			    The	default	location of the	hastmon	PID file.

EXIT STATUS
       Exit  status  is	 0  on	success,  or  one  of  the values described in
       sysexits(3) on failure.

EXAMPLES
       Launch hastmon on both nodes and	start watchdog	on  third  node.   Set
       role for	resource shared	to primary on nodeA and	to secondary on	nodeB.

	     nodeB# hastmon
	     nodeB# hastmonctl role secondary shared

	     nodeA# hastmon
	     nodeA# hastmonctl role primary shared

	     nodeA# hastmon
	     nodeA# hastmonctl role watchdog shared

SEE ALSO
       hastmon.conf(5),	hastmonctl(8).

AUTHORS
       The hastmon was developed by Mikolaj Golub <to.my.trociny@gmail.com>.

FreeBSD	Ports 14.quarterly     October 20, 2010			    HASTMON(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=hastmon&sektion=8&manpath=FreeBSD+Ports+14.3.quarterly>

home | help