HEARTBEAT(8)

πŸ’– heartbeat β€” the manual, but make it a group chat πŸ’–

okay bestie, so this is heartbeat from section 8 of the manual β€” that's the system administration utilities section, iykyk. buckle up, we're doing High-Availability Linux and we're doing it cutely πŸ’…


✨ NAME ✨

heartbeat β€” the Heartbeat subsystem for High-Availability Linux 🫢


🌸 DESCRIPTION 🌸

okay so heartbeat is a basic heartbeat subsystem for Linux-HA. literally what it does is: it runs scripts at initialisation, and it runs scripts when machines go up or down. the way that it's giving glow-up energy is that this version will also do IP address takeover using gratuitous ARPs. no cap. it works correctly for a 2-node configuration, and it's extensible to larger configurations. so it can grow with you, bestie. main character energy fr fr 🌈

it implements the following kinds of heartbeats:

  • UDP/IP v4 broadcast;
  • UDP/IP v4/v6 multicast;
  • UDP/IP v4/v6 unicast;
  • even such exotic protocols as TIPC or RDS. (not me being obsessed with how extra that is 😭)
  • Bidirectional Serial Rings ("raw" serial ports) β€” > ⚠️ this type is deprecated and should no longer be used;
  • special "ping" heartbeats for routers, etc. β€” > ⚠️ this type has been superseded by functionality in pacemaker() and should no longer be used.

so yeah, two of those are giving legacy, do not touch. periodt.

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/. go read it, it's iconic πŸ“šβœ¨


πŸŽ€ OPTIONS πŸŽ€

The following options are supported by heartbeat:

  • -d β€” Increment debugging level. Higher levels are more verbose. so like, more -d, more yapping about what's happening πŸ”
  • -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. bye bestie πŸ’€
  • -s β€” Report heartbeat status. the vibe check πŸ¦‹
  • -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. the flex πŸ’…

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. fr fr, use the init script, it's the moment πŸ‘‘


πŸ”— SEE ALSO πŸ”—

ha.cf(5), authkeys(5)


πŸ‘‘ AUTHORS πŸ‘‘

  • Alan Robertson <alanr@unix.sh>
    • heartbeat
  • Lars Ellenberg <lars.ellenberg@linbit.com>
    • Heartbeat Maintainer; code fixes; documentation updates
  • 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

and that's the whole thing bestie!! this page is Heartbeat 3.0.6, dated 2 Dec 2014 β€” so yeah, vintage, but still serving looks. mwah πŸ’–βœ¨πŸŽ€πŸ¦‹πŸŒΈπŸ’…πŸ«Ά