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

FreeBSD Manual Pages

  
 
  

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

NAME
       hastmonctl -- hastmon control utility

SYNOPSIS
       hastmonctl  create  [-d]	 [-c  config]  [-e  extentsize]	[-k keepdirty]
		  [-m mediasize] name ...
       hastmonctl role [-d] [-c	config]	<init |	primary	 |  secondary>	all  |
		  name ...
       hastmonctl status [-d] [-c config] [all | name ...]
       hastmonctl dump [-d] [-c	config]	[all | name ...]

DESCRIPTION
       The  hastmonctl	utility	 is  used  to  control	the  behaviour	of the
       hastmon(8) daemon.

       This utility should be used to setup initial hastmon resources role and
       check the resources' current status.

       The first argument to hastmonctl	indicates an action to be performed:

       role    Change role of the given	resource.  The role can	be one of:

	       init	  Resource is turned off.

	       primary	  The resource will be started and run on this node.

	       secondary  Local	hastmon(8) daemon will act as  secondary  node
			  for the given	resource - it will wait	for connection
			  from	the  primary node and will handle requests re-
			  ceived from it.  Also	 it  will  receive  complaints
			  from	watchdog  and initiate switching to primary if
			  there	are complaints and no connection from primary.

	       status	  Present status of the	configured resources.

	       In addition, every subcommand can be followed by	the  following
	       options:

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

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

FILES
       /usr/local/etc/hastmon.conf
			    Configuration file for hastmonctl and hastmon(8).
       /var/run/hastmonctl  Control  socket  used by hastmonctl	to communicate
			    with the hastmon(8)	daemon.

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

EXAMPLES
       Run  shared resource on nodeA (primary) and nodeB (secondary) and start
       watchdog	on nodeC.

	     nodeB# hastmon
	     nodeB# hastmonctl role secondary shared

	     nodeA# hastmon
	     nodeA# hastmonctl role primary shared

	     nodeC# hastmon
	     nodeC# hastmonctl role watchdog shared

       Switch roles for	the shared resource.

	     nodeA# hastmonctl role secondary shared

	     nodeB# hastmonctl role primary shared

SEE ALSO
       sysexits(3), hastmon.conf(5), hastmon(8).

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

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

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

home | help