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

-s, --list-targets=value

List the device's target

-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


October 2017 Pacemaker 1.1.18-0.1.rc2.fc28.2 System Administration Utilities