FENCE_AGENT(8)

✨ FENCE_AGENT(8) ✨

okay bestie, so this is fence_dummy — the Dummy fence agent, from the System Manager's Manual, section 8 (that's the sysadmin-y one 💅). buckle up, it's giving very unserious energy but the facts are 100% real.

---

🎀 NAME 🎀

fence_dummy — Dummy fence agent. yeah. that's the whole name. iconic of her honestly.

---

🌸 DESCRIPTION 🌸

so like, fence_dummy. that's it. that's the agent.

the fence agent is flexible like that — it takes options on the command line and from stdin. when fenced execs the agent, it sends parameters through stdin. but you can also just run the agent all by yourself with command line options, which is lowkey so useful for testing and for turning outlets on or off from scripts. no cap. 🫶

Vendor URL: http://www.example.com

---

💖 PARAMETERS 💖

• -o, --action=[action] — the fencing action you want. (Default Value: reboot)
• --random_sleep_range=[seconds] — throws in a sleep somewhere between 1 and X seconds. this one's for testing, bestie. 🧚
• --status-file=[file] — the file that holds the status. (Default Value: /tmp/fence_dummy.status)
• --type=[type] — which flavour of dummy fence agent you want. (Default Value: file)
• -q, --quiet — kills logging to stderr. heads up though: it does not affect --verbose, --debug-file, or logging to syslog. she's specific like that. 💅
• -v, --verbose — verbose mode, babes. you can stack multiple -v flags on the command line (like, -vvv) to crank the verbosity up. go off. 🔥
• --verbose-level — how much debugging detail shows up in the output. defaults to the number of --verbose flags you dropped on the command line, or to 1 if verbose=1 in a stonith device configuration (i.e., on stdin).
• -D, --debug-file=[debugfile] — writes debug info to the file you give it.
• -V, --version — shows version info and dips. ✌️
• -h, --help — shows help and dips.
• --plug-separator=[char] — the separator used for the plug parameter when you're specifying more than 1 plug. (Default Value: ,)
• --delay=[seconds] — waits X seconds before fencing even starts. (Default Value: 0)
• --disable-timeout=[true/false] — disables the timeout, true/false style. (default: true when run from Pacemaker 2.0+)
• --login-timeout=[seconds] — waits X seconds for the cmd prompt after login. (Default Value: 5)
• --power-timeout=[seconds] — tests for X seconds waiting for the status to change after ON/OFF. (Default Value: 20)
• --power-wait=[seconds] — waits X seconds after issuing ON/OFF. (Default Value: 0)
• --shell-timeout=[seconds] — waits X seconds for the cmd prompt after issuing a command. (Default Value: 3)
• --stonith-status-sleep=[seconds] — sleeps X seconds between status calls during a STONITH action. (Default Value: 1)
• --retry-on=[attempts] — how many attempts to retry power on. (Default Value: 1)

---

⭐ ACTIONS ⭐

• on — Power on machine. let there be light. ✨
• off — Power off machine. bye bestie. 💀
• reboot — Reboot machine. the classic glow-up-and-restart.
• status — This returns the status of the plug/virtual machine.
• monitor — Check the health of fence device. doing a little vibe check on it. 🩺
• metadata — Display the XML metadata describing this resource.
• manpage — The operational behavior of this is not known. (not me finding out mid-rewrite 😭)
• validate-all — Validate if all required parameters are entered. a little homework check. 📝

---

🦋 STDIN PARAMETERS 🦋

• action — Fencing action (Default Value: reboot)
• random_sleep_range — Issue a sleep between 1 and X seconds. Used for testing.
• status_file — File with status (Default Value: /tmp/fence_dummy.status)
• type — Type of the dummy fence agent (Default Value: file)
• quiet — Disable logging to stderr. Does not affect --verbose or --debug-file or logging to syslog.
• verbose — Verbose mode. Multiple -v flags can be stacked on the command line (e.g., -vvv) to increase verbosity.
• verbose_level — Level of debugging detail in output. Defaults to the number of --verbose flags specified on the command line, or to 1 if verbose=1 in a stonith device configuration (i.e., on stdin).
• debug_file — Write debug information to given file. Obsoletes: debug
• version — Display version information and exit
• help — Display help and exit
• plug_separator — Separator for plug parameter when specifying more than 1 plug (Default Value: ,)
• delay — Wait X seconds before fencing is started (Default Value: 0)
• disable_timeout — Disable timeout (true/false) (default: true when run from Pacemaker 2.0+)
• login_timeout — Wait X seconds for cmd prompt after login (Default Value: 5)
• power_timeout — Test X seconds for status change after ON/OFF (Default Value: 20)
• power_wait — Wait X seconds after issuing ON/OFF (Default Value: 0)
• shell_timeout — Wait X seconds for cmd prompt after issuing command (Default Value: 3)
• stonith_status_sleep — Sleep X seconds between status calls during a STONITH action (Default Value: 1)
• retry_on — Count of attempts to retry power on (Default Value: 1)

---

and that's the whole page, bestie!! 🎀

this absolute baddie of a manpage comes to you courtesy of fence_dummy (Fence Agent), dated 2009-10-20, living its best life in FENCE_AGENT(8). she's been iconic since 2009 and she's not stopping. periodt. 👑💜