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

AUTHOR

134       Written by Andrew Beekhof
135

REPORTING BUGS

137       Report bugs to users@clusterlabs.org
138
139
140
141Pacemaker 2.0.0-5.fc29            April 2019                      PACEMAKER(8)