OCF_HEARTBEAT_MACHIN(7)

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

✨ ocf_heartbeat_machine-info ✨

okay bestie, welcome to the manual page for ocf_heartbeat_machine-info, from the OCF resource agents family 💖 it's giving "quietly essential infrastructure" and honestly? we're obsessed.

🌸 NAME 🌸

ocf_heartbeat_machine-info — records various node attributes in the CIB 💅

🎀 SYNOPSIS 🎀

machine-info [start | stop | monitor | meta-data | validate-all]

🦋 DESCRIPTION 🦋

so basically this one is a Virtual Machine and Container Registration Service Resource Agent. say that five times fast, i dare you 😭

what it does is record attributes into the CIB about how many virtual machines and containers are currently running on the node. and how does it find out? it uses systemd machinectl, no cap. 🧚

sample output, for the visual learners:

machines: 5

that's it. that's the whole vibe. ✨

💜 SUPPORTED PARAMETERS 💜

  • pidfile — the PID file, bestie. it's optional, it's a string, and it defaults to /run/resource-agents/MachineInfo-RESOURCE_ID 🫶
  • delay — the interval that lets the values stabilize before we go believing them. optional, string, default "0s". give it a lil breathing room, she deserves it 🌈

👑 SUPPORTED ACTIONS 👑

this resource agent supports the following actions (operations), and yes we're going through every single one because they all matter:

  • start — starts the resource. suggested minimum timeout: 20s ⭐
  • stop — stops the resource. suggested minimum timeout: 20s 💀 (not really, it's fine, i just love that emoji)
  • monitor — performs a detailed status check. suggested minimum timeout: 20s. suggested interval: 60s 🔥 this is the one that keeps checking in on things, main character energy fr fr
  • meta-data — retrieves resource agent metadata (internal use only, so like, don't touch, it's not for you 🙈). suggested minimum timeout: 5s
  • validate-all — performs a validation of the resource configuration. suggested minimum timeout: 20s ✅

🍓 EXAMPLE CRM SHELL 🍓

here's an example config for a machine-info resource using the crm(8) shell, copy it exactly bestie, character for character:

primitive p_machine-info ocf:heartbeat:machine-info \
  op monitor timeout="20s" interval="60s"

🌈 EXAMPLE PCS 🌈

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

pcs resource create p_machine-info ocf:heartbeat:machine-info \
  op monitor timeout="20s" interval="60s"

🌟 SEE ALSO 🌟

💖 AUTHOR 💖

ClusterLabs contributors (see the resource agent source for information about individual authors) — collective slay, honestly 🫶

heads up bestie: this page is from resource-agents version UNKNOWN, dated 04/08/2026. that's the whole thing! go forth and register those machines, you absolute icon 👑💅✨
📦 where this page comes from