OCF_HEARTBEAT_LVM(7)

💅 OCF_HEARTBEAT_LVM(7) — the ocf_heartbeat_LVM page, but make it make sense

okay so bestie, welcome to the manual page for ocf_heartbeat_LVM 💖 this is the OCF resource agents corner of the world and this page is literally all about it. grab a lil snack 🍓, we're learning.

---

🌸 NAME 🌸

ocf_heartbeat_LVM — controls the availability of an LVM Volume Group. yes. that's the whole vibe. it keeps your volume group alive or not alive and it takes that job very seriously 👑

---

✨ SYNOPSIS ✨

LVM [start | stop | status | monitor | meta-data | validate-all]

that's the lineup, no cap. those are the actions you can throw at it 🫶

---

🎀 DESCRIPTION 🎀

So this is a resource script for LVM. it manages a Linux Volume Manager volume (LVM) as an HA resource. that's it, that's the tea 🦋 it's the main character that makes your volume group behave like a proper high-availability resource.

---

💜 SUPPORTED PARAMETERS 💜

these are the knobs you get to twiddle. every single one, no skipping 🙈

• volgrpname — the name of the volume group. that's literally it, that's the whole thing.

(unique, required, string, no default) — so yeah, required, you can't skip it, and there's no default hiding behind the curtain 💀

• exclusive — if you set this, the volume group gets activated exclusively. and it works one of two ways, bestie, listen:
  • if the volume group has the cluster attribute set, then it gets activated exclusively using clvmd across the cluster 🌀
  • if the cluster attribute is not set, then it gets activated exclusively using a tag and the volume_list filter 🏷️
  • and when the tag option is in use, the volume_list in lvm.con must be initialized. it can be as simple as setting 'volume_list = []' depending on your setup ✨

(optional, boolean, default false)

• tag — if "exclusive" is set on a non clustered volume group, this overrides the tag to be used 🎯

(optional, string, default "pacemaker")

• partial_activation — if set, the volume group will be activated partially, even with some physical volumes missing 😭 it helps to set this to true when you're using mirrored logical volumes 🪞

(optional, string, default "false")

---

🔥 SUPPORTED ACTIONS 🔥

this resource agent supports the following actions (operations). the timeouts are suggested minimums, mkay, so don't come at me 🫶

• start — starts the resource. suggested minimum timeout: 30s ⏱️
• stop — stops the resource. suggested minimum timeout: 30s
• status — performs a status check. suggested minimum timeout: 30s
• monitor — performs a detailed status check. suggested minimum timeout: 30s. suggested interval: 10s 👀 (yeah it's got an interval, she's thorough)
• methods — suggested minimum timeout: 5s
• meta-data — retrieves resource agent metadata (internal use only 🤫). suggested minimum timeout: 5s
• validate-all — performs a validation of the resource configuration. suggested minimum timeout: 5s

---

🧚 EXAMPLE CRM SHELL 🧚

here's what a LVM resource looks like configured with the crm(8) shell — copy it, love it, ship it 💅

primitive p_LVM ocf:heartbeat:LVM \
  params \
    volgrpname=string \
  op monitor depth="0" timeout="30s" interval="10s"

---

🌈 EXAMPLE PCS 🌈

and here's the same energy but with pcs(8) — note the OCF_CHECK_LEVEL instead of depth, ikyk 😌

pcs resource create p_LVM ocf:heartbeat:LVM \
  volgrpname=string \
  op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="10s"

---

🦋 SEE ALSO 🦋

• http://clusterlabs.org/ — go say hi to the clusterlabs girlies ⭐

---

👑 AUTHOR 👑

ClusterLabs contributors 🫶 (see the resource agent source for info about the individual authors — they're the real ones, fr fr)

---

okay that's the whole page bestie, you ate that 💖 go configure some volume groups and remember: volgrpname is required, no default, no exceptions 💀

signing off with the receipts: this is resource-agents UNKNOWN, dated 10/01/2026, and the page is OCF_HEARTBEAT_LVM(7) 🎀✨