APPHBD(8)

📦
version 3.0.6 · 2 versions
  • 3.0.6 · debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 3.0.6 · ubuntu jammy
, in debian bookworm, debian trixie, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 APPHBD — apphbd, like, the Application Heartbeat Monitor for High-Availability Linux 💖

okay bestie, sit down, hydrate, and let me tell you about apphbd — it lives in section 8 of the manual (system administration utilities, very grown-up of it) ✨

🥺 NAME

apphbd — Application Heartbeat Monitor for High-Availability Linux

🌸 SYNOPSIS

apphbd [-srkdh] [-c file]

💅 DESCRIPTION

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

no because that's the whole vibe check right there 😭 she's iconic but she's retired, we don't use her anymore, periodt.

/usr/libexec/heartbeat/apphbd is a basic application heartbeat monitor daemon for Linux-HA. A whole group of Application Heartbeat APIs are defined for this heartbeat monitoring service. Applications may register with the daemon in order to be monitored. And if an application fails to send a heartbeat within the specified interval — boom — the daemon will log an event. 👀

apphbd may use a watchdog timer to monitor itself. self-care king, honestly 🫶

apphbd extends its functionality by using plugins. One plugin, recmgr, notifies the recovery manager daemon if certain events occur (e.g. an application fails to heartbeat). she's got friends, she's got a group chat 💬

The Recovery Manager daemon (/usr/libexec/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. So apphbd should be started first, with the recmgr plugin loaded. Then, recoverymgrd should be configured and started. order matters bestie, it's giving choreography 🩰

✨ OPTIONS ✨

The following options are supported:

  • -s — Show the status of apphbd, running or stopped. status check, we love a wellness check 💖
  • -k — Stop (kill) the daemon. it's not personal, it's just business 💀
  • -r — Restart the daemon. apphbd will reload its configuration file when restarted. glow-up via refresh 🌈
  • -d level — Set the debug level.
  • -h — Show a brief usage message. help me help you 🥺
  • -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. pick your own adventure 🎀

🦋 FILES

  • /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)

💜 AUTHORS

  • Alan Robertson <alanr@unix.sh>
    • apphbd
  • Andrea Brugger <andrea.l.brugger@intel.com>
    • man page
  • Florian Haas <florian.haas@linbit.com>
    • man page

and that's the whole page, bestie 🫶 this was Heartbeat 3.0.6, dated November 26, 2009 — so yes, she's vintage, she's a classic, she lowkey ate and left no crumbs, but also she's deprecated so maybe don't @ her for new setups 💅✨🌷

📦 where this page comes from