OCF_HEARTBEAT_NAMED(7)

OCF_HEARTBEAT_NAMED(7) 💖

okay bestie, so this is a page from the OCF resource agents manual (that's the manual name, cute right?), and it's all about ocf_heartbeat_named — the resource agent that manages a <purple>named</purple> server. she's giving cluster royalty, no cap. 👑

---

✨ NAME ✨

ocf_heartbeat_named — Manages a named server 🎀

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

So this is the resource script for the named (Bind) server — yep, the classic DNS one. It manages named as an HA resource, which basically means the cluster gets to babysit it for you. main character energy fr fr 💅

---

💜 SUPPORTED PARAMETERS 💜

Every single knob you can turn, listed with love. 🌈

• named — the path to the named command itself. (optional, string, default "/usr/sbin/named")
• rndc — path to the rndc command. (optional, string, default "/usr/sbin/rndc")
• host — path to the host command. (optional, string, default "/usr/bin/host")
• named_user — the user that should own the named process. (optional, string, default "named")
• named_config — configuration file for named. (unique, optional, string, no default)
• named_pidfile — the PIDFILE file for named. (unique, optional, string, default "/var/run/named/named.pid")
• named_rootdir — directory that named should use for chroot, if any. (unique, optional, string, no default)
• named_options — options for the named process, if any. (optional, string, no default)
• named_keytab_file — named service keytab file (for GSS-TSIG, iykyk). (optional, string, no default)
• rndc_options — options for the rndc process, if any. (optional, string, no default)
• host_options — options for the host process, if any. (optional, string, no default)
• monitor_request — the request that shall be sent to named for monitoring. Usually an A record in DNS. (optional, string, default "localhost")
• monitor_response — the expected response from the named server. (optional, string, default "127.0.0.1")
• monitor_ip — IP Address where named listens. (optional, string, default "127.0.0.1")

---

👑 SUPPORTED ACTIONS 👑

This resource agent supports the following actions (operations), and honestly? she ate: 🔥

• start — Starts the resource. Suggested minimum timeout: 60s.
• stop — Stops the resource. Suggested minimum timeout: 60s.
• reload — Suggested minimum timeout: 60s.
• status — Performs a status check. Suggested minimum timeout: 10s.
• monitor — Performs a detailed status check. Suggested minimum timeout: 30s. Suggested interval: 30s. 👀
• 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.
• methods — Suggested minimum timeout: 5s.

---

🎀 EXAMPLE CRM SHELL 🎀

Here's an example config for a named resource using the crm(8) shell — copy it, it's iconic:

primitive p_named ocf:heartbeat:named \
  op monitor depth="0" timeout="30s" interval="30s"

---

⭐ EXAMPLE PCS ⭐

And here's the same vibe but for pcs(8):

pcs resource create p_named ocf:heartbeat:named \
  op monitor OCF_CHECK_LEVEL="0" timeout="30s" interval="30s"

---

🫶 SEE ALSO 🫶

http://clusterlabs.org/ — go say hi 💖

---

💀 AUTHOR 💀

ClusterLabs contributors (see the resource agent source for information about individual authors). we love the contributors, periodt. 🌸

---

ngl bestie, this page is from resource-agents version UNKNOWN, dated 10/01/2026 — slay, go configure your DNS cluster, you've got this 💅✨🍓