OCF_HEARTBEAT_POUND(7)

💅 OCF_HEARTBEAT_POUND 💅

okay bestie, welcome to the manual page for ocf_heartbeat_pound — that's manual section 7, in case you were wondering, and yes we're doing this whole thing together. grab a strawberry drink 🍓, we're managing a Pound instance.

---

🌸 NAME 🌸

ocf_heartbeat_pound — manage a Pound instance. that's it, that's the whole vibe. she runs Pound. she's the resource agent for it. iconic behavior honestly 👑

---

✨ SYNOPSIS ✨

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

look at her. six little actions. so clean. so demure. 💖

---

🦋 DESCRIPTION 🦋

so basically the Pound Resource Agent can manage Pound instances. that's the whole deal, fr fr — it handles the lifecycle and the checking of your Pound, and you tell it how to do that with the parameters down below. no cap. 🫶

---

🎀 SUPPORTED PARAMETERS 🎀

every one of these matters, bestie. no skipping. this is the whole list and you're gonna read all of it 💅

• config — the Pound configuration file that Pound should actually manage. like, for example, "/etc/pound.cfg".

it's unique, required, a string, and has no default — so yeah, you HAVE to give her this one. she's not guessing. 🙈

• name — overrides the name of the instance that should be given to Pound. if you don't say anything, it just defaults to the resource identifier.

unique, optional, string, default "RESOURCE_ID".

• pid — writes the process's PID to the file you specify. the default will include the name you gave, so like: "/var/run/pound_production.pid".

and ngl, the manpage itself is like — despite what this help message shows, it's most likely not necessary to change this parameter. so like. leave her alone. she's fine. 🧚

unique, optional, string, default "/var/run/pound_RESOURCE_ID.pid".

• binary — this is what gets used to start the Pound server. normally you'd use pound.

optional, string, default "pound".

• ctl_binary — this one is used to watch Pound status via Unix socket. normally you'd use poundctl.

optional, string, default "poundctl".

• socket_path — writes the process's Unix socket. this parameter is the same as the 'Control' parameter in the configuration file, i.e.: Control "/var/lib/pound/pound.cfg".

optional, string, default "/var/lib/pound/pound.cfg".

• maxfiles — determines how many files pound is allowed to open at a time. this one helps fix the 'Too many open files' error message. lowkey a lifesaver when that error shows up and everyone starts panicking 😭

optional, integer, no default.

---

🔥 SUPPORTED ACTIONS 🔥

this resource agent supports the following actions (operations). timeouts are suggested minimums, so don't come for me if you set them lower and things get spicy:

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

---

🌈 EXAMPLE CRM SHELL 🌈

here's an example config for a pound resource using the crm(8) shell. copy it, love it, run it:

primitive p_pound ocf:heartbeat:pound \
  params \
    config=string \
  op monitor timeout="20s" interval="10s" depth="0"

---

💜 EXAMPLE PCS 💜

and here's the same energy but for a pound resource using pcs(8):

pcs resource create p_pound ocf:heartbeat:pound \
  config=string \
  op monitor timeout="20s" interval="10s" OCF_CHECK_LEVEL="0"

see how it's giving the same thing but with OCF_CHECK_LEVEL="0" instead of depth="0"? slay. she contains multitudes. ✨

---

🌟 SEE ALSO 🌟

• http://clusterlabs.org/

that's the link. go look at it. iykyk 🦋

---

🫶 AUTHOR 🫶

ClusterLabs contributors (see the resource agent source for information about individual authors). absolute legends, every single one of them. 👑

---

and that's the whole page, bestie!! this one's from resource-agents UNKNOWN, dated 04/08/2026 — so if you're reading this, hi, that's the version and that's the date, no cap. now go configure your Pound and be the main character of your cluster. periodt 💅✨🎀