'\" t
.\"     Title: apphbd
.\"    Author: Alan Robertson <alanr@unix.sh>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: November 26, 2009
.\"    Manual: System administration utilities
.\"    Source: Heartbeat 3.0.6
.\"  Language: English
.\"
.TH "APPHBD" "8" "November 26, 2009" "Heartbeat 3.0.6" "System administration utilitie"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
apphbd \- Application Heartbeat Monitor for High\-Availability Linux
.SH "SYNOPSIS"
.PP
\fBapphbd\fR
[\fB\-srkdh\fR] [\fB\-c\fR
\fIfile\fR]
.SH "DESCRIPTION"
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBWarning\fR
.ps -1
.br
.PP
\fBapphbd\fR
is deprecated; its use is strongly discouraged\&. The functionality provided by
\fBapphbd\fR
has been replaced by resource\-level monitoring in Pacemaker\&.
.sp .5v
.RE
.PP
\fB/usr/libexec/heartbeat/apphbd\fR
is a basic application heartbeat monitor daemon for Linux\-HA\&. A group of Application Heartbeat APIs are defined for this heartbeat monitoring service\&. Applications may register with the daemon in order to be monitored\&. If an application fails to send a heartbeat within the specified interval, the daemon will log an event\&.
.PP
apphbd may use a watchdog timer to monitor itself\&.
.PP
apphbd extends its functionality by using plugins\&. A plugin,
recmgr
notifies the recovery manager daemon if certain events occur (e\&.g\&. an application fails to heartbeat)\&.
.PP
The Recovery Manager daemon (\fB/usr/libexec/heartbeat/recoverymgrd\fR) receives notification from the
recmgr
plugin, then it tries to execute recovery scripts as configured\&. See the
\fBrecoverymgrd\fR
default configuration file,
recoverymgrd\&.conf
for details\&.
.PP
\fBrecoverymgrd\fR
registers itself with
\fBapphbd\fR
as a client application\&.
\fBapphbd\fR
should be started first with the
recmgr
plugin loaded\&. Then,
recoverymgrd
should be configured and started
.SH "OPTIONS"
.PP
The following options are supported:
.PP
\fB\-s\fR
.RS 4
Show the status of apphbd, running or stopped\&.
.RE
.PP
\fB\-k\fR
.RS 4
Stop (kill) the daemon\&.
.RE
.PP
\fB\-r\fR
.RS 4
Restart the daemon\&.
\fBapphbd\fR
will reload its configuration file when restarted\&.
.RE
.PP
\fB\-d\fR \fIlevel\fR
.RS 4
Set the debug level\&.
.RE
.PP
\fB\-h\fR
.RS 4
Show a brief usage message\&.
.RE
.PP
\fB\-c\fR \fIfile\fR
.RS 4
Set an alternate configuration file\&. The default configuration file is
\&./apphbd\&.cf\&. For details on the file format and supported options, refer to the example
apphbd\&.cf
file found in the documentation directory\&.
.RE
.SH "FILES"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
/run/apphbd\&.pid
\(en default PID file
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
apphbd\&.cf
\(en Default configuration file for
\fBapphbd\fR\&.
\fBapphbd\fR
searches the file in its working directory\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
recoverymgrd\&.conf
\(en default configuration file for recoverymgrd\&. recoverymgrd searches the file in its working directory\&. An alternative configuration file may be specified on the command line\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
/usr/lib/heartbeat/plugins/AppHBNotification
\(en directory containing plugins for
\fBapphbd\fR\&.
.RE
.SH "SEE ALSO"
.PP
\fBheartbeat\fR(8)
.SH "AUTHORS"
.PP
\fBAlan Robertson\fR <\&alanr@unix\&.sh\&>
.RS 4
apphbd
.RE
.PP
\fBAndrea Brugger\fR <\&andrea\&.l\&.brugger@intel\&.com\&>
.RS 4
man page
.RE
.PP
\fBFlorian Haas\fR <\&florian\&.haas@linbit\&.com\&>
.RS 4
man page
.RE