Scroll to navigation

PACEMAKER(8) System Administration Utilities PACEMAKER(8)

NAME

Pacemaker - Part of the Pacemaker cluster resource manager

SYNOPSIS

stonith_admin <command> [<options>]

DESCRIPTION

stonith_admin - access the Pacemaker fencing API

OPTIONS

-?, --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.

Device definition commands:

Register the named stonith device. Requires: --agent. Optional: any number of --option and/or --env entries.

-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.

Queries:

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.

Fencing Commands:

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.
Show last successful fencing operation for named node (or '*' for all nodes). Optional: --timeout, --quiet (show only the operation's epoch timestamp), --verbose (show all recorded and pending operations).
Indicate when the named node was last fenced. Optional: --as-node-id.

Additional Options:

The agent to use (for example, fence_xvm; with --register, --metadata).
Specify a device configuration parameter as NAME=VALUE (with --register).
specified name, using the value of the environment variable of the same name prefixed with OCF_RESKEY_ (with --register).
Identify fencing operations in logs with the specified tag; useful when multiple entities might invoke stonith_admin (used with most commands).
A device to associate with a given host and stonith level (with --register-level).
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).

AUTHOR

Written by Andrew Beekhof

REPORTING BUGS

Report bugs to users@clusterlabs.org

June 2018 Pacemaker 1.1.18-3.el6