HEARTBEAT(8) System administration utilitie HEARTBEAT(8)NAME
heartbeat - Heartbeat subsystem for High-Availability Linux
DESCRIPTION
heartbeat is a basic heartbeat subsystem for Linux-HA. It will run scripts at initialisation, and when machines go up or down. This version
will also perform IP address takeover using gratuitous ARPs. It works correctly for a 2-node configuration, and is extensible to larger
configurations.
It implements the following kinds of heartbeats:
o UDP/IP broadcast;
o UDP/IP multicast;
o UDP/IP unicast;
o Bidirectional Serial Rings ("raw" serial ports) -- this type is deprecated and should no longer be used;
o special "ping" heartbeats for routers, etc. -- this type has been superseded by functionality in pacemaker() and should no longer be
used.
Comprehensive documentation on heartbeat is available in the Heartbeat User's Guide. If this documentation is not installed on your system,
it can be found at http://linux-ha.org/.
OPTIONS
The following options are supported by heartbeat:
-d
Increment debugging level. Higher levels are more verbose.
-r
Reload heartbeat. This option is functionally identical to sending a running heartbeat process a HUP signal. If the configuration has
not changed, then this option is essentially a no-op. If ha.cf(5) or authkeys(5) has changed, then heartbeat will re-read these files
and update its configuration.
This option may not be used together with -R.
-k
Kill (stop) heartbeat.
-s
Report heartbeat status.
-R
Heartbeat restart exec flag (internal use only). May not be used with -r.
-C
Heartbeat current resource state for restart (internal use only). Only valid with -R.
-V
Print out heartbeat version.
Note that most of these options are used for supporting the heartbeat init script, which provides the conventional start, stop, status and
restart options (among others). It is recommended to use this rather than invoking the heartbeat command directly.
SEE ALSO ha.cf(5), authkeys(5)AUTHORS
Alan Robertson <alanr@unix.sh>
heartbeat
Juan Pedro Paredes Caballero <juampe@retemail.es>
man page
Simon Horman <horms@verge.net.au>
man page
Florian Haas <florian.haas@linbit.com>
man page
Heartbeat 3.0.5 24 Nov 2009 HEARTBEAT(8)
Check Out this Related Man Page
DRBDLINKS(8) System Manager's Manual DRBDLINKS(8)NAME
drbdlinks - manages links into a shared DRBD partition
SYNOPSIS
drbdlinks [OPTION]... [start|stop|auto|status|monitor]
DESCRIPTION
drbdlinks is a program which manages links into a DRBD partition which is shared among several machines. It is meant to be used in con-
junction with the heartbeat system for simplifying management of high availability clusters. A simple configuration file, "/etc/drb-
dlinks.conf", specifies the links. This can be used to manage links for "/etc/apache", "/var/lib/pgsql", and other system files and direc-
tories that need to appear as if they are local to the system when running applications after a DRBD shared partition has been mounted.
A sample configuration file with annotations is included in the drbdlinks distribution.
When run with "start" as the mode, drbdlinks will rename the existing files/directories, and then make symbolic links into the DRBD parti-
tion. "stop" does the reverse.
The "monitor" and "status" modes will check the file-system against the configuration file and will report "running" (monitor mode) or "OK"
(status mode) if all links appear to be up. Otherwise they report "down" or "stopped" (respectively).
By default, the rename appends .drbdlinks to the name, but this can be overridden in the configuration file.
The "list" mode just show the list of links, with each line showing the link, destination, and a 0/1 flag for bindMount status. This may
be useful for user scripts without having to parse the configuration.
An init script is included which runs "stop" before heartbeat starts, and after heartbeat stops. This is done to try to ensure that when
the shared partition isn't mounted, the links are in their normal state.
OPTIONS
drbdlinks has several options, using either short or long variants.
-h, --help
Print a short help message describing the available options and exit.
-c, --config-file=CONFIGFILE
Specify an alternate config file. The default config file is /etc/drbdlinks.conf. Alternate config files should have a "drb-
dlinks-" prefix, e.g. "drbdlinks-httpd.conf".
-s, --suffix=SUFFIX
Name to append to the local file-system name when the link is in place. The default is "drbdlinks", which would result in a renamed
file like "/etc/httpd.drbdlinks".
-v, --verbose
Increase verbosity level by 1 for every occurrence of this option.
EXAMPLES
Here are a few examples of how drbdlinks can be used.
The most straight-forward, and default, method for starting drbdlinks:
drbdlinks start
To use a suffix different from the default when linking to a file or directory, the -s option can be used, specifying the desired string:
drbdlinks -s orig start
would rename the file-system name to "name.orig".
Increase the verbosity to assist in debugging:
drbdlinks -v -v start
Use an alternate configuration file, possibly from with a DRBD mounted file-system:
drbdlinks -c /shared1/drbdlinks-httpd.conf start
This would use the specified configuration file, found on our DRBD device mounted on /shared1. This would allow us to easily keep drb-
dlinks configurations tied to a specific set of data on a DRBD disk in an active/active sort of HA configuration.
SEE ALSO DRBD(8), drbdadm(8), drbdsetup(8), heartbeat(8).
AUTHOR
drbdlinks was written by Sean Reifschneider <jafo@tummy.com>.
This manual page was written by Cyril Bouthors <cyril@bouthors.org>, for the Debian project (but may be used by others). Sean Reifschnei-
der modified it for status and monitor arguments, and included it in the base drbdlinks release. Mike Loseke <mike@tummy.com> added the
sections on options and examples.
September 3, 2008 DRBDLINKS(8)