stonith_admin man page

Pacemaker — Part of the Pacemaker cluster resource manager


stonith_admin mode [options]


stonith_admin - Provides access to the stonith-ng API.

Allows the administrator to add/remove/list devices, check device and host status and fence hosts


-?, --help
This text
-$, --version
Version information
-V, --verbose
Increase debug output
-q, --quiet
Print only essential output


-l, --list=value
List devices that can terminate the specified host
-L, --list-registered
List all registered devices
-I, --list-installed
List all installed devices

-M, --metadata Check the device's metadata

-Q, --query=value
Check the device's status
-F, --fence=value
Fence the named host
-U, --unfence=value
Unfence the named host
-B, --reboot=value
Reboot the named host
-C, --confirm=value
Confirm the named host is now safely down
-H, --history=value
Retrieve last fencing operation for specified node (or '*' for all)
-h, --last=value
Indicate when the named node was last fenced. Optional: --as-node-id
-R, --register=value
Register the named stonith device. Requires: --agent, optional: --option

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

-r, --register-level=value

Register a stonith level for the named target, specified as one of:

NAME, @PATTERN, or ATTR=VALUE. Requires: --index, one or more --device entries

-d, --deregister-level=value

De-register a stonith level for the named target

Target is specified as for --register-level. Requires: --index

Options and modifiers

-a, --agent=value
The agent (eg. fence_xvm) to instantiate when calling with --register

-e, --env-option=value

-o, --option=value

-T, --tag=value

Identify fencing operations with the specified tag.

Useful when there are multiple entities that might be invoking stonith_admin(8)

-v, --device=value
A device to associate with a given host and stonith level
-i, --index=value
The stonith level (1-9)
-t, --timeout=value
Operation timeout in seconds
-n, --as-node-id
(Advanced) The supplied node is the corosync nodeid (Only for use with --last)
(Advanced) Do nothing if an equivalent --fence request succeeded less than N seconds earlier

-L, --list-all legacy alias for --list-registered


Written by Andrew Beekhof

Reporting Bugs

Report bugs to


December 2016 Pacemaker 1.1.16-1.fc26 System Administration Utilities