DragonFly On-Line Manual Pages

HASTMONCTL(8)          DragonFly 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 received 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>.

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