OCF_HEARTBEAT_ZFS(7)

💖 OCF_HEARTBEAT_ZFS 💖

okay bestie, welcome to ocf_heartbeat_ZFS — that's the OCF_HEARTBEAT_ZFS(7) manual page, and she's literally the resource agent that manages ZFS pools. no cap. let's get into it 🦋

---

✨ NAME ✨

ocf_heartbeat_ZFS — manages ZFS pools. that's it, that's the whole job, and she does it flawlessly 💅

---

🌸 SYNOPSIS 🌸

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

five actions, pick your fighter 👑

---

🎀 DESCRIPTION 🎀

so this script manages ZFS pools 🫶 it can import a ZFS pool, or export it. import = she's in her welcoming era, bringing the pool into the picture. export = she's saying bye, gracefully, main character exit. that's the vibe. that's the whole thing. it's giving "I do one job and I ate." 🔥

---

💜 SUPPORTED PARAMETERS 💜

these are the lil knobs you get to turn, bestie. read them carefully, fr fr:

• pool — the name of the ZFS pool she's gonna manage, like "tank". for example: "tank". that's the example, that's the pool name. (unique, required, string, no default) — so yeah, you HAVE to give her one, there's no backup plan here 😭
• importargs — the arguments handed over to zpool import, e.g. "-d /dev/disk/by-id". (optional, string, no default) — optional, so if you don't say anything, nothing gets passed. she respects your silence ✨
• importforce — when this is on, zpool import gets handed the -f option. (optional, boolean, default true) — lowkey important: the default is true, so out of the box she IS force-importing. if you don't want the -f, you gotta say so yourself 🙈

---

👑 SUPPORTED ACTIONS 👑

this resource agent supports the following actions (operations) — and each one comes with a suggested minimum timeout, which is basically the "girl, give me at least this long" number:

• start — starts the resource. suggested minimum timeout: 60s. ⭐
• stop — stops the resource. suggested minimum timeout: 60s. 🌈
• monitor — performs a detailed status check. suggested minimum timeout: 30s. suggested interval: 5s. she's checking in on you every 5 seconds, that's love 🥺
• validate-all — performs a validation of the resource configuration. suggested minimum timeout: 30s. 🧚
• meta-data — retrieves resource agent metadata (internal use only). suggested minimum timeout: 5s. not for you, bestie, that's her private business 💀

---

💅 EXAMPLE CRM SHELL 💅

here's what a ZFS resource config looks like using the crm(8) shell. copy-paste-able, iconic, no notes:

primitive p_ZFS ocf:heartbeat:ZFS \
  params \
    pool=string \
  op monitor depth="0" timeout="30s" interval="5s"

---

🍓 EXAMPLE PCS 🍓

and here's the same energy for a ZFS resource using pcs(8) — different tool, same slay:

pcs resource create p_ZFS ocf:heartbeat:ZFS \
  pool=string \
  op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="5s"

---

🌟 SEE ALSO 🌟

• http://clusterlabs.org/ — go say hi, she's lovely 💖

---

🫶 AUTHOR 🫶

ClusterLabs contributors (see the resource agent source for information about individual authors). a whole squad of legends, and honestly? we stan 🌸

---

ok that's the whole page bestie, you're officially ZFS-pilled. go forth and manage those pools 💅✨

---

and that's a wrap!! this was resource-agents UNKNOWN, dated 04/08/2026 — written from the OCF_HEARTBEAT_ZFS(7) manual page. mwah, bye bye 🎀💖