OCF_HEARTBEAT_STORAG(7)

💅 OCF_HEARTBEAT_STORAG(7) — like, the storage-mon page but make it make sense 🎀

okay so real talk, this is from section 7 of the manuals (iykyk) and it's literally the ocf_heartbeat_storage-mon page. bestie, we're about to get into it. ✨

---

🌸 NAME 🌸

ocf_heartbeat_storage-mon — storage I/O health status, no cap 💖

🦋 SYNOPSIS 🦋

storage-mon [start | stop | monitor | meta-data | validate-all]

periodt. those are your whole world, bestie. 👑

🌈 DESCRIPTION 🌈

okay so this is a System health agent. it checks the storage I/O status of the drives you give it and then updates the #health-storage attribute. the way that works is honestly iconic. 💅

highkey, usage is highly recommended in combination with the HealthSMART monitoring agent. iykyk. 🫶

and ngl, it's giving limited — the agent currently supports a maximum of 25 devices per instance. not me being the 26th drive 😭. keep that in mind fr fr.

💜 SUPPORTED PARAMETERS 💜

• state_file — the location where we store the resource state in. it's unique, optional, string type, and has a default of "/run/resource-agents/storage-mon-RESOURCE_ID.state". slay, it already knows where to put things. 🎀
• drives — the drive(s) to check, given as a SPACE separated list. enter the full path to the device, e.g. "/dev/sda". it's unique, required, string type, and has no default. you gotta tell her which drives, bestie. 🙈
• io_timeout — specify the disk I/O timeout in seconds. minimum 1, recommended 10 (that's the default, queen behavior). it's optional, integer, default 10. ⏱️
• check_interval — specify the interval between I/O checks in seconds. (only supported with the daemonize option, fyi!) it's optional, integer, default 30. 🕰️
• inject_errors — used only for testing! 💀 specify the % of I/O errors to simulate drive failures. it's optional, integer, and has no default. don't be out here injecting errors for fun, that's not the vibe. 🚨
• daemonize — specifies to start storage-mon as a daemon and check for devices. it's optional, boolean, default false. 🧚

⭐ SUPPORTED ACTIONS ⭐

this resource agent supports the following actions (operations), bestie — memorize the timeouts, they're giving study guide 📚:

• start — starts the resource. suggested minimum timeout: 10s. go, go, go! 🔥
• stop — stops the resource. suggested minimum timeout: 120s. okay, she takes her time. 💀
• monitor — performs a detailed status check. suggested minimum timeout: 120s. suggested interval: 30s. the way that she's checking in on you 💖
• meta-data — retrieves the resource agent metadata (internal use only). suggested minimum timeout: 5s. 🎀
• validate-all — performs a validation of the resource configuration. suggested minimum timeout: 10s. accountability, we love to see it. 🫶

🎀 EXAMPLE CRM SHELL 🎀

this is literally the example configuration for a storage-mon resource using the crm(8) shell — iconic:

primitive p_storage-mon ocf:heartbeat:storage-mon \
  params \
    drives=string \
  op monitor timeout="120s" interval="30s" start-delay="0s"

🌸 EXAMPLE PCS 🌸

and this one's the example configuration for a storage-mon resource using pcs(8) — ate and left no crumbs:

pcs resource create p_storage-mon ocf:heartbeat:storage-mon \
  drives=string \
  op monitor timeout="120s" interval="30s" start-delay="0s"

👑 SEE ALSO 👑

http://clusterlabs.org/ — go be nosy, bestie. 🦋

💜 AUTHOR 💜

ClusterLabs contributors (see the resource agent source for information about individual authors). we stan. 💖

---

okay bestie that's the whole thing, and for the sign-off: this page goes out to the resource-agents fam, the UNKNOWN version, dated 10/01/2026, and it's the OCF_HEARTBEAT_STORAG(7) page — mwah, periodt. 💅✨🍓