HASTMONCTL(8) BSD System Manager's Manual HASTMONCTL(8)NAMEhastmonctl — hastmon control utility
SYNOPSIShastmonctl 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 received
from it. Also it will receive complaints from watch‐
dog 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 spec‐
ified 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 ALSOsysexits(3), hastmon.conf(5), hastmon(8).
AUTHORS
The hastmonctl was developed by Mikolaj Golub ⟨to.my.trociny@gmail.com⟩.
BSD October 20, 2010 BSD
