1PACEMAKER(8)            System Administration Utilities           PACEMAKER(8)
2
3
4

NAME

6       Pacemaker - Part of the Pacemaker cluster resource manager
7

SYNOPSIS

9       stonith_admin <command> [<options>]
10

DESCRIPTION

12       stonith_admin - access the Pacemaker fencing API
13

OPTIONS

15       -?, --help
16              Display this text and exit.
17
18       -$, --version
19              Display version information and exit.
20
21       -V, --verbose
22              Increase debug output (may be specified multiple times).
23
24       -q, --quiet
25              Be less descriptive in output.
26
27       -c, --cleanup
28              Cleanup wherever appropriate.
29
30       -b, --broadcast
31              Broadcast wherever appropriate.
32
33       --output-as=value
34              Specify the format for output, one of: text, xml
35
36       --output-to=value
37              Specify  the destination for formatted output, "-" for stdout or
38              a filename
39
40   Device definition commands:
41       -R, --register=value
42              Register the named stonith device. Requires: --agent.  Optional:
43              --option, --env-option.
44
45       -D, --deregister=value De-register the named stonith device.
46
47       -r, --register-level=value
48              Register  a stonith level for the named target, specified as one
49              of NAME, @PATTERN, or ATTR=VALUE.  Requires: --index and one  or
50              more --device entries.
51
52       -d, --deregister-level=value
53              Unregister  a  stonith  level for the named target, specified as
54              for --register-level. Requires: --index.
55
56   Queries:
57       -l, --list=value
58              List devices that can terminate the specified  host.   Optional:
59              --timeout.
60
61       -L, --list-registered
62              List all registered devices. Optional: --timeout.
63
64       -I, --list-installed
65              List all installed devices. Optional: --timeout.
66
67       -s, --list-targets=value
68              List  the  targets  that  can  be  fenced  by  the named device.
69              Optional: --timeout.
70
71       -M, --metadata
72              Show agent metadata. Requires: --agent.  Optional: --timeout.
73
74       -Q, --query=value
75              Check the named device's status. Optional: --timeout.
76
77       -H, --history=value
78              Show last successful fencing operation for named  node  (or  '*'
79              for  all  nodes).  Optional: --timeout, --cleanup, --quiet (show
80              only the  operation's  epoch  timestamp),  --verbose  (show  all
81              recorded  and  pending  operations), --broadcast (update history
82              from all nodes available).
83
84       -h, --last=value
85              Indicate  when  the  named  node  was  last  fenced.   Optional:
86              --as-node-id.
87
88       -K, --validate
89              Validate  a  fence  device  configuration.   Requires:  --agent.
90              Optional: --option, --env-option, --quiet (print no output, only
91              return status).
92
93   Fencing Commands:
94       -F, --fence=value
95              Fence named host. Optional: --timeout, --tolerance.
96
97       -U, --unfence=value
98              Unfence named host. Optional: --timeout, --tolerance.
99
100       -B, --reboot=value
101              Reboot named host. Optional: --timeout, --tolerance.
102
103       -C, --confirm=value
104              Tell cluster that named host is now safely down.
105
106   Additional Options:
107       -a, --agent=value
108              The  agent  to  use  (for  example,  fence_xvm; with --register,
109              --metadata, --validate).
110
111       -o, --option=value
112              Specify a device configuration parameter as NAME=VALUE  (may  be
113              specified multiple times; with --register, --validate).
114
115       -e,  --env-option=value  Specify  a device configuration parameter with
116       the
117              specified name, using the value of the environment  variable  of
118              the same name prefixed with OCF_RESKEY_ (may be specified multi‐
119              ple times; with --register, --validate).
120
121       -T, --tag=value
122              Identify fencing operations in logs with the specified tag; use‐
123              ful when multiple entities might invoke stonith_admin (used with
124              most commands).
125
126       -v, --device=value
127              Device ID (with --register-level, device  to  associate  with  a
128              given host and level; may be specified multiple times).
129
130       -i, --index=value
131              The  stonith  level  (1-9)  (with  --register-level,  --deregis‐
132              ter-level).
133
134       -t, --timeout=value
135              Operation timeout in seconds (default 120; used with  most  com‐
136              mands).
137
138       -n, --as-node-id
139              (Advanced)  The  supplied  node  is  the  corosync node ID (with
140              --last).
141
142       --tolerance=value
143              (Advanced) Do nothing if an equivalent --fence request succeeded
144              less  than  this  many seconds earlier (with --fence, --unfence,
145              --reboot).
146

AUTHOR

148       Written by Andrew Beekhof
149

REPORTING BUGS

151       Report bugs to users@clusterlabs.org
152
153
154
155Pacemaker 2.0.2-1.fc31.1           July 2019                      PACEMAKER(8)