DOKK / manpages / debian 10 / pacemaker-cli-utils / stonith_admin.8.en
PACEMAKER(8) System Administration Utilities PACEMAKER(8)

Pacemaker - Part of the Pacemaker cluster resource manager

stonith_admin <command> [<options>]

stonith_admin - access the Pacemaker fencing API

-?, --help
Display this text and exit.
-$, --version
Display version information and exit.
Increase debug output (may be specified multiple times).
Be less descriptive in output.
Cleanup wherever appropriate.
Broadcast wherever appropriate.

Register the named stonith device. Requires: --agent. Optional: --option, --env-option.

-D, --deregister=value De-register the named stonith device.

Register a stonith level for the named target, specified as one of NAME, @PATTERN, or ATTR=VALUE. Requires: --index and one or more --device entries.
Unregister a stonith level for the named target, specified as for --register-level. Requires: --index.

List devices that can terminate the specified host. Optional: --timeout.
List all registered devices. Optional: --timeout.
List all installed devices. Optional: --timeout.
List the targets that can be fenced by the named device. Optional: --timeout.
Show agent metadata. Requires: --agent. Optional: --timeout.
Check the named device's status. Optional: --timeout.
Show last successful fencing operation for named node (or '*' for all nodes). Optional: --timeout, --cleanup, --quiet (show only the operation's epoch timestamp), --verbose (show all recorded and pending operations), --broadcast (update history from all nodes available).
Indicate when the named node was last fenced. Optional: --as-node-id.
Validate a fence device configuration. Requires: --agent. Optional: --option, --env-option, --quiet (print no output, only return status).

Fence named host. Optional: --timeout, --tolerance.
Unfence named host. Optional: --timeout, --tolerance.
Reboot named host. Optional: --timeout, --tolerance.
Tell cluster that named host is now safely down.

The agent to use (for example, fence_xvm; with --register, --metadata, --validate).
Specify a device configuration parameter as NAME=VALUE (may be specified multiple times; with --register, --validate).
specified name, using the value of the environment variable of the same name prefixed with OCF_RESKEY_ (may be specified multiple times; with --register, --validate).
Identify fencing operations in logs with the specified tag; useful when multiple entities might invoke stonith_admin (used with most commands).
Device ID (with --register-level, device to associate with a given host and level; may be specified multiple times).
The stonith level (1-9) (with --register-level, --deregister-level).
Operation timeout in seconds (default 120; used with most commands).
(Advanced) The supplied node is the corosync node ID (with --last).
(Advanced) Do nothing if an equivalent --fence request succeeded less than this many seconds earlier (with --fence, --unfence, --reboot).

Written by Andrew Beekhof

Report bugs to users@clusterlabs.org

August 2022 Pacemaker 2.0.1