OCF_HEARTBEAT_LINUXS(7)

💖 OCF_HEARTBEAT_LINUXS(7) 💖

okay bestie, pull up a chair, we're reading the ocf_heartbeat_LinuxSCSI page from the OCF resource agents collection (that's the manual section 7, for the record) 🎀

---

✨ NAME ✨

ocf_heartbeat_LinuxSCSI — turns SCSI devices on and off through the kernel's SCSI hot-plug subsystem. and yes, she's deprecated 💀 (we'll get to that, don't panic)

---

✨ SYNOPSIS ✨

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

that's the whole vibe. six actions, pick your fighter 🌈

---

✨ DESCRIPTION ✨

deprecation warning, listen up: this agent uses Linux SCSI hot-plug functionality, which has been superseded by SCSI reservations. it is deprecated and may be removed from a future release. check out the scsi2reservation and sfex agents for alternatives. not me warning you twice, but like... 🚨

anyway 💅 this is a resource agent for LinuxSCSI. it manages the availability of a SCSI device from the point of view of the Linux kernel. it makes Linux believe the device has gone away, and it can make it come back again. that's it, that's the whole job — she's giving ghosting-and-then-texting-back energy 👻

---

✨ SUPPORTED PARAMETERS ✨

• scsi — the SCSI instance to be managed. lowkey the main character here.

(required, string, no default)

• ignore_deprecation — if set to true, it suppresses the deprecation warning for this agent. basically a "don't @ me" switch 🙈

(optional, boolean, default false)

---

✨ SUPPORTED ACTIONS ✨

this resource agent supports the following actions (operations), and yes, every single one has a suggested minimum timeout, we are not skipping a single number fr fr:

• start — starts the resource. suggested minimum timeout: 20s.
• stop — stops the resource. suggested minimum timeout: 20s.
• methods — suggested minimum timeout: 5s.
• status — performs a status check. suggested minimum timeout: 20s. suggested interval: 10s.
• monitor — performs a detailed status check. suggested minimum timeout: 20s. suggested interval: 10s.
• meta-data — retrieves resource agent metadata (internal use only, bestie, don't touch 🫶). suggested minimum timeout: 5s.
• validate-all — performs a validation of the resource configuration. suggested minimum timeout: 5s.

---

✨ EXAMPLE CRM SHELL ✨

here's how you'd configure a LinuxSCSI resource using the crm(8) shell, copied exactly, no cap:

primitive p_LinuxSCSI ocf:heartbeat:LinuxSCSI \
  params \
    scsi=string \
  op monitor depth="0" timeout="20s" interval="10s"

---

✨ EXAMPLE PCS ✨

and the same thing but using pcs(8) ✨

pcs resource create p_LinuxSCSI ocf:heartbeat:LinuxSCSI \
  scsi=string \
  op monitor OCF_CHECK_LEVEL="0" timeout="20s" interval="10s"

---

✨ SEE ALSO ✨

• http://clusterlabs.org/ 🌐

---

✨ AUTHOR ✨

ClusterLabs contributors (see the resource agent source for information about individual authors) 👑

---

okay that's the whole page, you ate that 🍓 go forth and manage your SCSI devices (or, y'know, migrate to scsi2reservation or sfex, since this one's deprecated — i'm just saying 👀)

this has been resource-agents UNKNOWN, dated 04/08/2026, signing off 💜 mwah, bye bestie!!