HASTMON(8) BSD System Manager's Manual HASTMON(8)NAMEhastmon — cluster monitoring daemon
SYNOPSIShastmon [-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 run‐
ning as primary to the one running as secondary. When primary hastmon is
unable to connect or connection fails, it will try to re-establish con‐
nection 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 watch‐
dog.
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 spec‐
ified 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 ALSOhastmon.conf(5), hastmonctl(8).
AUTHORS
The hastmon was developed by Mikolaj Golub ⟨to.my.trociny@gmail.com⟩.
BSD October 20, 2010 BSD