OCF_HEARTBEAT_ASTERI(7)

💖 OCF_HEARTBEAT_ASTERI(7) 💖

okay bestie, welcome to the OCF resource agents corner of the manual, where we're talking about ocf_heartbeat_asterisk — the lil agent that manages an Asterisk PBX. yes, the whole phone system. she's got range. 🎀

---

✨ NAME ✨

ocf_heartbeat_asterisk — manages an Asterisk PBX 🌸

---

🦋 SYNOPSIS 🦋

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

---

💅 DESCRIPTION 💅

So this is a resource agent for the Asterisk PBX. It can manage an Asterisk PBX telephony system, or it can manage a clone set that forms an Asterisk distributed device setup. like, either vibe. one Asterisk or a whole little squad of them. 🔥

---

🎀 SUPPORTED PARAMETERS 🎀

every param, no skips, periodt:

• binary — where the Asterisk PBX server binary lives. (optional, string, default "asterisk")
• canary_binary — where the Asterisk PBX Canary server binary lives. (optional, string, default "astcanary")
• config — the Asterisk PBX configuration file. (optional, string, default "/etc/asterisk/asterisk.conf")
• user — the user that runs the Asterisk PBX daemon. (optional, string, default "asterisk")
• group — the group that runs the Asterisk PBX daemon (this one's for logfile and directory permissions, iykyk). (optional, string, default "asterisk")
• additional_parameters — extra parameters passed to the Asterisk PBX on startup (like -L <load> or -M <value>, for example). (optional, string, default "-g -vvv")
• realtime — decides whether the Asterisk PBX daemon runs with realtime priority or not. (optional, boolean, default false)
• maxfiles — decides how many files the Asterisk PBX is allowed to open at one time. helps fix that 'Too many open files' error message, which is giving stressed. (optional, integer, default 8192)
• monitor_sipuri — a SIP URI to check when monitoring. during monitor, the agent will attempt to do a SIP OPTIONS request against this URI. requires the sipsak utility to be present and executable. if it's unset, the agent does no SIP URI monitoring at all. (optional, string, no default)

---

🌈 SUPPORTED ACTIONS 🌈

this resource agent supports the following actions (operations), bestie:

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

---

⭐ EXAMPLE CRM SHELL ⭐

here's an example config for an asterisk resource using the crm(8) shell:

primitive p_asterisk ocf:heartbeat:asterisk \
  op monitor timeout="30s" interval="20s"

---

💜 EXAMPLE PCS 💜

and here's the same energy for an asterisk resource using pcs(8):

pcs resource create p_asterisk ocf:heartbeat:asterisk \
  op monitor timeout="30s" interval="20s"

---

👑 SEE ALSO 👑

• http://clusterlabs.org/

---

🫶 AUTHOR 🫶

ClusterLabs contributors (see the resource agent source for information about individual authors). love that for them, fr fr. 💖

---

and that's the whole page bestie, no gatekeeping, no cap. go configure your Asterisk. slay. 🧚✨

this lil masterpiece came to you from resource-agents UNKNOWN, dated 04/08/2026 — mwah, take care of her 💅🍓