OCF_HEARTBEAT_NODEUT(7)

💅 ocf_heartbeat_NodeUtilization — like, the manual page for ocf_heartbeat_NodeUtil(7) bestie ✨

okay so. gather round. this is the OCF_HEARTBEAT_NODEUT(7) page, section 7 of the manual, and it's literally all about the NodeUtilization resource agent. it's short, it's sweet, and it's gonna tell your cluster what it's working with. let's go 🎀

---

🌸 NAME 🌸

ocf_heartbeat_NodeUtilization — Node Utilization, no cap. that's the whole name, that's the whole vibe 💖

---

✨ SYNOPSIS ✨

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

those are your five actions, bestie. pick one. any one. (well, pick the right one, but you get it 🫶)

---

🦋 DESCRIPTION 🦋

okay so the Node Utilization agent is like the friend who shows up to the group chat with receipts. it detects your system parameters — available CPU, host memory, and hypervisor memory availability — and then it adds them into the CIB for each node using crm_attribute. blessed behavior, honestly 👑

here's the move: you run the agent as a clone resource so it goes and populates those parameters on each node. every node gets its own little data drop, iykyk 🌈

⚠️ heads up, important note: setting hv_memory only works with Xen at the moment, using the xl or xm command line tools. like, Xen only. don't come for me, that's just what the page says 😭

---

🧚 SUPPORTED PARAMETERS 🧚

• dynamic — if you set this, the parameters get updated whenever there's a difference between the HA parameters and the system values while the monitor action is running. if you don't set it, the parameters get set once when the resource instance starts. set-and-forget vs. always-fresh, your choice ✨ (optional, boolean, default true)
• utilization_cpu — turns on setting the node CPU utilization limit. yes queen, track that CPU 💅 (optional, boolean, default true)
• utilization_cpu_reservation — subtracts this value when setting the CPU utilization parameter. like leaving room in the car for the aux cord owner 😌 (optional, integer, default 1)
• utilization_host_memory — enables setting available host memory. memory check bestie 🧠 (optional, boolean, default true)
• utilization_host_memory_reservation — subtract this value when setting host memory utilization, in MB. cushion for the memory, fr fr (optional, integer, default 512)
• utilization_hv_memory — enables setting available hypervisor memory. (remember: Xen only, xl or xm, see above 🫶) (optional, boolean, default true)
• utilization_hv_memory_reservation — subtract this value when setting hypervisor memory utilization, in MB. more cushion 💜 (optional, integer, default 512)

---

🔥 SUPPORTED ACTIONS 🔥

this resource agent supports the following actions (operations). iconic list incoming:

• start — starts the resource. suggested minimum timeout: 90s. let it cook ⭐
• stop — stops the resource. suggested minimum timeout: 100s. bye bestie, gracefully 👋
• monitor — performs a detailed status check. suggested minimum timeout: 20s. suggested interval: 60s. the vibe check, literally 💀
• meta-data — retrieves resource agent metadata (internal use only). suggested minimum timeout: 5s. don't touch unless you know, ngl 🙈
• validate-all — performs a validation of the resource configuration. suggested minimum timeout: 30s. proofread before you send the text, always 🎀

---

🍓 EXAMPLE CRM SHELL 🍓

here's an example config for a NodeUtilization resource using the crm(8) shell — copy/paste ready, no notes:

primitive p_NodeUtilization ocf:heartbeat:NodeUtilization \
  op monitor timeout="20s" interval="60s"

ate. no crumbs. 💖

---

🌈 EXAMPLE PCS 🌈

and here's the same thing but for pcs(8), main character tool energy:

pcs resource create p_NodeUtilization ocf:heartbeat:NodeUtilization \
  op monitor timeout="20s" interval="60s"

slay. same resource, different CLI, both iconic 👑

---

👑 SEE ALSO 👑

go touch grass on the internet, bestie:

• http://clusterlabs.org/

---

💜 AUTHOR 💜

ClusterLabs contributors — see the resource agent source for information about individual authors. (they're the ones who made this whole thing happen, show some love 🫶)

---

okay that's the whole page!! and before you close the terminal — cute sign-off time: this page came from resource-agents UNKNOWN, dated 10/01/2026, and yes it's page OCF_HEARTBEAT_NODEUT(7), go forth and populate those parameters bestie 💅✨🎀