NAME

hastmonctl — hastmon control utility

SYNOPSIS

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