.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.8.
.TH PACEMAKER "8" "November 2020" "Pacemaker 2.0.1" "System Administration Utilities"
.SH NAME
Pacemaker \- Part of the Pacemaker cluster resource manager
.SH SYNOPSIS
.B stonith_admin
\fI\,<command> \/\fR[\fI\,<options>\/\fR]
.SH DESCRIPTION
stonith_admin \- access the Pacemaker fencing API
.SH OPTIONS
.TP
\-?, \fB\-\-help\fR
Display this text and exit.
.TP
\-$, \fB\-\-version\fR
Display version information and exit.
.TP
\fB\-V\fR, \fB\-\-verbose\fR
Increase debug output (may be specified multiple times).
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Be less descriptive in output.
.TP
\fB\-c\fR, \fB\-\-cleanup\fR
Cleanup wherever appropriate.
.TP
\fB\-b\fR, \fB\-\-broadcast\fR
Broadcast wherever appropriate.
.SS "Device definition commands:"
.TP
\fB\-R\fR, \fB\-\-register\fR=\fI\,value\/\fR
Register the named stonith device. Requires: \fB\-\-agent\fR.
Optional: \fB\-\-option\fR, \fB\-\-env\-option\fR.
.HP
\fB\-D\fR, \fB\-\-deregister\fR=\fI\,value\/\fR De\-register the named stonith device.
.TP
\fB\-r\fR, \fB\-\-register\-level\fR=\fI\,value\/\fR
Register a stonith level for the named target,
specified as one of NAME, @PATTERN, or ATTR=VALUE.
Requires: \fB\-\-index\fR and one or more \fB\-\-device\fR entries.
.TP
\fB\-d\fR, \fB\-\-deregister\-level\fR=\fI\,value\/\fR
Unregister a stonith level for the named target,
specified as for \fB\-\-register\-level\fR. Requires: \fB\-\-index\fR.
.SS "Queries:"
.TP
\fB\-l\fR, \fB\-\-list\fR=\fI\,value\/\fR
List devices that can terminate the specified host.
Optional: \fB\-\-timeout\fR.
.TP
\fB\-L\fR, \fB\-\-list\-registered\fR
List all registered devices. Optional: \fB\-\-timeout\fR.
.TP
\fB\-I\fR, \fB\-\-list\-installed\fR
List all installed devices. Optional: \fB\-\-timeout\fR.
.TP
\fB\-s\fR, \fB\-\-list\-targets\fR=\fI\,value\/\fR
List the targets that can be fenced by the
named device. Optional: \fB\-\-timeout\fR.
.TP
\fB\-M\fR, \fB\-\-metadata\fR
Show agent metadata. Requires: \fB\-\-agent\fR.
Optional: \fB\-\-timeout\fR.
.TP
\fB\-Q\fR, \fB\-\-query\fR=\fI\,value\/\fR
Check the named device's status. Optional: \fB\-\-timeout\fR.
.TP
\fB\-H\fR, \fB\-\-history\fR=\fI\,value\/\fR
Show last successful fencing operation for named node
(or '*' for all nodes). Optional: \fB\-\-timeout\fR, \fB\-\-cleanup\fR,
\fB\-\-quiet\fR (show only the operation's epoch timestamp),
\fB\-\-verbose\fR (show all recorded and pending operations),
\fB\-\-broadcast\fR (update history from all nodes available).
.TP
\fB\-h\fR, \fB\-\-last\fR=\fI\,value\/\fR
Indicate when the named node was last fenced.
Optional: \fB\-\-as\-node\-id\fR.
.TP
\fB\-K\fR, \fB\-\-validate\fR
Validate a fence device configuration.
Requires: \fB\-\-agent\fR. Optional: \fB\-\-option\fR, \fB\-\-env\-option\fR,
\fB\-\-quiet\fR (print no output, only return status).
.SS "Fencing Commands:"
.TP
\fB\-F\fR, \fB\-\-fence\fR=\fI\,value\/\fR
Fence named host. Optional: \fB\-\-timeout\fR, \fB\-\-tolerance\fR.
.TP
\fB\-U\fR, \fB\-\-unfence\fR=\fI\,value\/\fR
Unfence named host. Optional: \fB\-\-timeout\fR, \fB\-\-tolerance\fR.
.TP
\fB\-B\fR, \fB\-\-reboot\fR=\fI\,value\/\fR
Reboot named host. Optional: \fB\-\-timeout\fR, \fB\-\-tolerance\fR.
.TP
\fB\-C\fR, \fB\-\-confirm\fR=\fI\,value\/\fR
Tell cluster that named host is now safely down.
.SS "Additional Options:"
.TP
\fB\-a\fR, \fB\-\-agent\fR=\fI\,value\/\fR
The agent to use (for example, fence_xvm;
with \fB\-\-register\fR, \fB\-\-metadata\fR, \fB\-\-validate\fR).
.TP
\fB\-o\fR, \fB\-\-option\fR=\fI\,value\/\fR
Specify a device configuration parameter as NAME=VALUE
(may be specified multiple times; with \fB\-\-register\fR,
\fB\-\-validate\fR).
.TP
\fB\-e\fR, \fB\-\-env\-option\fR=\fI\,value\/\fR Specify a device configuration parameter with the
specified name, using the value of the
environment variable of the same name prefixed with
OCF_RESKEY_ (may be specified multiple times;
with \fB\-\-register\fR, \fB\-\-validate\fR).
.TP
\fB\-T\fR, \fB\-\-tag\fR=\fI\,value\/\fR
Identify fencing operations in logs with the specified
tag; useful when multiple entities might invoke
stonith_admin (used with most commands).
.TP
\fB\-v\fR, \fB\-\-device\fR=\fI\,value\/\fR
Device ID (with \fB\-\-register\-level\fR, device to associate with
a given host and level; may be specified multiple times).
.TP
\fB\-i\fR, \fB\-\-index\fR=\fI\,value\/\fR
The stonith level (1\-9) (with \fB\-\-register\-level\fR,
\fB\-\-deregister\-level\fR).
.TP
\fB\-t\fR, \fB\-\-timeout\fR=\fI\,value\/\fR
Operation timeout in seconds (default 120;
used with most commands).
.TP
\fB\-n\fR, \fB\-\-as\-node\-id\fR
(Advanced) The supplied node is the corosync node ID
(with \fB\-\-last\fR).
.TP
\fB\-\-tolerance\fR=\fI\,value\/\fR
(Advanced) Do nothing if an equivalent \fB\-\-fence\fR request
succeeded less than this many seconds earlier
(with \fB\-\-fence\fR, \fB\-\-unfence\fR, \fB\-\-reboot\fR).
.SH AUTHOR
Written by Andrew Beekhof
.SH "REPORTING BUGS"
Report bugs to users@clusterlabs.org