.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH PACEMAKER "8" "December 2016" "Pacemaker 1.1.16" "System Administration Utilities"
.SH NAME
Pacemaker \- Part of the Pacemaker cluster resource manager
.SH SYNOPSIS
.B stonith_admin
\fI\,mode \/\fR[\fI\,options\/\fR]
.SH DESCRIPTION
stonith_admin \- Provides access to the stonith\-ng API.
.PP
Allows the administrator to add/remove/list devices, check device and host status and fence hosts
.SH OPTIONS
.TP
\-?, \fB\-\-help\fR
This text
.TP
\-$, \fB\-\-version\fR
Version information
.TP
\fB\-V\fR, \fB\-\-verbose\fR
Increase debug output
.TP
\fB\-q\fR, \fB\-\-quiet\fR
Print only essential output
.SS "Commands:"
.TP
\fB\-l\fR, \fB\-\-list\fR=\fI\,value\/\fR
List devices that can terminate the specified host
.TP
\fB\-L\fR, \fB\-\-list\-registered\fR
List all registered devices
.TP
\fB\-I\fR, \fB\-\-list\-installed\fR
List all installed devices
.HP
\fB\-M\fR, \fB\-\-metadata\fR Check the device's metadata
.TP
\fB\-Q\fR, \fB\-\-query\fR=\fI\,value\/\fR
Check the device's status
.TP
\fB\-F\fR, \fB\-\-fence\fR=\fI\,value\/\fR
Fence the named host
.TP
\fB\-U\fR, \fB\-\-unfence\fR=\fI\,value\/\fR
Unfence the named host
.TP
\fB\-B\fR, \fB\-\-reboot\fR=\fI\,value\/\fR
Reboot the named host
.TP
\fB\-C\fR, \fB\-\-confirm\fR=\fI\,value\/\fR
Confirm the named host is now safely down
.TP
\fB\-H\fR, \fB\-\-history\fR=\fI\,value\/\fR
Retrieve last fencing operation for specified node (or '*' for all)
.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\-R\fR, \fB\-\-register\fR=\fI\,value\/\fR
Register the named stonith device. Requires: \fB\-\-agent\fR, optional: \fB\-\-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:
.IP
NAME, @PATTERN, or ATTR=VALUE. Requires: \fB\-\-index\fR, one or more \fB\-\-device\fR entries
.TP
\fB\-d\fR, \fB\-\-deregister\-level\fR=\fI\,value\/\fR
De\-register a stonith level for the named target
.IP
Target is specified as for \fB\-\-register\-level\fR. Requires: \fB\-\-index\fR
.SS "Options and modifiers:"
.TP
\fB\-a\fR, \fB\-\-agent\fR=\fI\,value\/\fR
The agent (eg. fence_xvm) to instantiate when calling with \fB\-\-register\fR
.HP
\fB\-e\fR, \fB\-\-env\-option\fR=\fI\,value\/\fR 
.HP
\fB\-o\fR, \fB\-\-option\fR=\fI\,value\/\fR     
.TP
\fB\-T\fR, \fB\-\-tag\fR=\fI\,value\/\fR
Identify fencing operations with the specified tag.
.IP
Useful when there are multiple entities that might be invoking stonith_admin(8)
.TP
\fB\-v\fR, \fB\-\-device\fR=\fI\,value\/\fR
A device to associate with a given host and stonith level
.TP
\fB\-i\fR, \fB\-\-index\fR=\fI\,value\/\fR
The stonith level (1\-9)
.TP
\fB\-t\fR, \fB\-\-timeout\fR=\fI\,value\/\fR
Operation timeout in seconds
.TP
\fB\-n\fR, \fB\-\-as\-node\-id\fR
(Advanced) The supplied node is the corosync nodeid (Only for use with \fB\-\-last\fR)
.TP
\fB\-\-tolerance\fR=\fI\,value\/\fR
(Advanced) Do nothing if an equivalent \fB\-\-fence\fR request succeeded less than N seconds earlier
.HP
\fB\-L\fR, \fB\-\-list\-all\fR legacy alias for \fB\-\-list\-registered\fR
.SH AUTHOR
Written by Andrew Beekhof
.SH "REPORTING BUGS"
Report bugs to users@clusterlabs.org