DragonFly On-Line Manual Pages

Search: Section:  

HASTMON(8)             DragonFly 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-establish
     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
     arguments:

     -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>.

DragonFly 6.5-DEVELOPMENT      October 20, 2010      DragonFly 6.5-DEVELOPMENT

Search: Section: