Name

apphbd — Application Heartbeat Monitor for High-Availability Linux

Synopsis

apphbd [-srkdh] [-c file]

Description

[Warning]Warning

apphbd is deprecated; its use is strongly discouraged. The functionality provided by apphbd has been replaced by resource-level monitoring in Pacemaker.

/usr/lib/heartbeat/apphbd 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.

apphbd may use a watchdog timer to monitor itself.

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

The Recovery Manager daemon (/usr/lib/heartbeat/recoverymgrd) receives notification from the recmgr plugin, then it tries to execute recovery scripts as configured. See the recoverymgrd default configuration file, recoverymgrd.conf for details.

recoverymgrd registers itself with apphbd as a client application. apphbd should be started first with the recmgr plugin loaded. Then, recoverymgrd should be configured and started

Options

The following options are supported:

-s

Show the status of apphbd, running or stopped.

-k

Stop (kill) the daemon.

-r

Restart the daemon. apphbd will reload its configuration file when restarted.

-d level

Set the debug level.

-h

Show a brief usage message.

-c file

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.

Files

  • /var/run/apphbd.pid – default PID file

  • apphbd.cf – Default configuration file for apphbd. apphbd searches the file in its working directory.

  • recoverymgrd.conf – default configuration file for recoverymgrd. recoverymgrd searches the file in its working directory. An alternative configuration file may be specified on the command line.

  • /usr/lib/heartbeat/plugins/AppHBNotification – directory containing plugins for apphbd.

See also

heartbeat(8)