1APPHBD(8)                   System Manager's Manual                  APPHBD(8)
2
3
4

NAME

6       apphbd - Application Heartbeat Monitor for High-Availability Linux
7

SYNOPSIS

9       apphbd [ -srkdh ] [ -c configure file ]
10

DESCRIPTION

12       apphbd  is a basic application heartbeat monitor daemon for Linux-HA. A
13       group of Application Heartbeat APIs  are  defined  for  this  heartbeat
14       monitoring  service. Applications may register with the daemon in order
15       to be monitored. If an application fails to send a heartbeat within the
16       specified interval, the daemon will log an event.
17
18       apphbd may use watchdog timer to monitor itself.
19
20       apphbd  extends  its functionality by using plugins. Currently a plugin
21       recmgr is implemented to notify Recovery Manager daemon if some  events
22       (specified  in  apphb_notify.h)  happen  (e.g.  an application fails to
23       heartbeat).
24
25       The Recovery Manager daemon  recoverymgrd  receives  notification  from
26       recmgr plugin, then it tries to execute recovery scripts as configured.
27       See recoverymgrd default configure file recoverymgrd.conf for detail.
28
29       recoverymgrd registers itself with  apphbd  as  a  client  application.
30       apphbd  should  be  started  first  with  plugin  recmgr  loaded.  Then
31       configure and start recoverymgrd.
32
33       For details relating to the Application Heartbeat API, see apphb.h
34

OPTIONS

36       -s     Show the status of apphbd, running or stopped.
37
38       -k     Stop (kill) the daemon
39
40       -r     Restart the daemon.  apphbd  will  reload  configure  file  when
41              restarted.
42
43       -d     Set debug level
44
45       -h     Show help message
46
47       -c configure file
48              Configure   file   for   apphbd.   Default   configure  file  is
49              ./apphbd.cf.   User  can  configure  debug  setting,  log  file,
50              watchdog  setting,  plugins  and real time setting. For details,
51              see sample configure file apphbd.cf.
52

FILES

54       /var/run/apphbd.pid Default PID file.
55
56       apphbd.cf Default configure file for apphbd. apphbd searches  the  file
57       in  its  working  directory.   This  sample configure file is installed
58       together with other Heartbeat documents.
59
60       apphb.h Header for Application Heartbeat API.
61
62       recoverymgrd.conf Default configure file for recoverymgrd. recoverymgrd
63       searches  the  file  in its working directory. Other configure file can
64       also be specified in the command line.  This sample configure  file  is
65       installed together with other Heartbeat documents.
66
67       /usr/lib/heartbeat/plugins/AppHBNotification Directory contains plugins
68       for apphbd.
69
70

SEE ALSO

72       heartbeat(8)
73
74

DOCUMENTATION

76       More information may be found at http://www.linux-ha.org.
77
78

AUTHORS

80       apphbd - Alan Robertson <alanr@unix.sh> et al.
81       recoverymgrd - Andrea Brugger <andrea.l.brugger@intel.com> et al.
82       man page - Andrea Brugger <andrea.l.brugger@intel.com>
83                - Adam Li <adam.li@intel.com>
84
85
86
87
88                                 12th May 2004                       APPHBD(8)
Impressum