OCF_HEARTBEAT_PINGD(7)

📦
version 4.18.0 · 14 versions
, in fedora 43, fedora 44

💖 ocf_heartbeat_pingd — the OCF resource agents manual, but make it a group chat 💖

okay bestie, listen up, this is ocf_heartbeat_pingd from the OCF resource agents collection, and she's... she's going through something. we'll get to that. 🫶

✨ NAME ✨

ocf_heartbeat_pingd — she monitors connectivity to specific hosts or IP addresses (aka your "ping nodes"), and yes, she's deprecated, we're gonna talk about it. 💀

🌈 SYNOPSIS 🌈

pingd [start | stop | monitor | meta-data | validate-all]

🎀 DESCRIPTION 🎀

🚨 DEPRECATION WARNING: This agent is deprecated and may be removed from a future release. See the ocf:pacemaker:pingd resource agent for a supported alternative.

like, she still works, she's just on her way out the door. don't build your whole future on her, ok? 😭

So what does she actually do? This is a pingd Resource Agent. Her whole thing is that she records (in the CIB) the current number of ping nodes a node can connect to. that's it, that's the job. count the pings, write the number in the CIB, main character energy ✨

🌸 SUPPORTED PARAMETERS 🌸

okay these are the knobs and dials, every single one, no skipping, we're thorough here 💅

  • pidfile — the PID file. (optional, string, default "/run/resource-agents/pingd-RESOURCE_ID")
  • user — the user we want to run pingd as. (optional, string, default "root")
  • dampen — the time to wait (dampening) before further changes occur. yes, it's spelled "dampen", we love her anyway. (optional, integer, default 1s)
  • set — the name of the instance_attributes set to place the value in. rarely needs to be specified. (optional, integer, no default)
  • name — the name of the attributes to set. this is the name you'll use in the constraints. (optional, integer, default pingd)
  • section — the section to place the value in. also rarely needs to be specified. (optional, integer, no default)
  • multiplier — the number by which to multiply the number of connected ping nodes by. math! ✨ (optional, integer, no default)
  • host_list — the list of ping nodes to count. defaults to all configured ping nodes. rarely needs to be specified. (optional, integer, no default)
  • ignore_deprecation — if set to true, suppresses the deprecation warning for this agent. (yes, you can mute her. iconic behavior honestly.) (optional, boolean, default false)

💅 SUPPORTED ACTIONS 💅

this resource agent supports the following actions (operations):

  1. start — starts the resource. suggested minimum timeout: 20s.
  2. stop — stops the resource. suggested minimum timeout: 20s.
  3. monitor — performs a detailed status check. suggested minimum timeout: 20s. suggested interval: 10s.
  4. meta-data — retrieves resource agent metadata (internal use only, bestie, don't touch). suggested minimum timeout: 5s.
  5. validate-all — performs a validation of the resource configuration. suggested minimum timeout: 20s.

🦋 EXAMPLE CRM SHELL 🦋

here's an example config for a pingd resource using the crm(8) shell, verbatim, no cap:

primitive p_pingd ocf:heartbeat:pingd \
  op monitor depth="0" timeout="20s" interval="10s"

🍓 EXAMPLE PCS 🍓

and here's the same vibe but for pcs(8):

pcs resource create p_pingd ocf:heartbeat:pingd \
  op monitor OCF_CHECK_LEVEL="0" timeout="20s" interval="10s"

🧚 SEE ALSO 🧚

💜 AUTHOR 💜

ClusterLabs contributors (see the resource agent source for information about individual authors) 🫶

and that's the whole page, bestie!! 🌈✨ this was OCF_HEARTBEAT_PINGD(7), from resource-agents UNKNOWN, dated 04/08/2026. love her, remember she's deprecated, and go use the supported alternative, mwah 💖💅🎀

📦 where this page comes from