1PACEMAKER(8) System Administration Utilities PACEMAKER(8)
2
3
4
6 Pacemaker - Part of the Pacemaker cluster resource manager
7
9 stonith_admin <command> [<options>]
10
12 stonith_admin - access the Pacemaker fencing API
13
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 any number of --option and/or --env entries.
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 Fencing Commands:
65 -F, --fence=value
66 Fence named host. Optional: --timeout, --tolerance.
67
68 -U, --unfence=value
69 Unfence named host. Optional: --timeout, --tolerance.
70
71 -B, --reboot=value
72 Reboot named host. Optional: --timeout, --tolerance.
73
74 -C, --confirm=value
75 Tell cluster that named host is now safely down.
76
77 -H, --history=value
78 Show last successful fencing operation for named node (or '*'
79 for all nodes). Optional: --timeout, --quiet (show only the
80 operation's epoch timestamp), --verbose (show all recorded and
81 pending operations).
82
83 -h, --last=value
84 Indicate when the named node was last fenced. Optional:
85 --as-node-id.
86
87 Additional Options:
88 -a, --agent=value
89 The agent to use (for example, fence_xvm; with --register,
90 --metadata).
91
92 -o, --option=value
93 Specify a device configuration parameter as NAME=VALUE (with
94 --register).
95
96 -e, --env-option=value Specify a device configuration parameter with
97 the
98 specified name, using the value of the environment variable of
99 the same name prefixed with OCF_RESKEY_ (with --register).
100
101 -T, --tag=value
102 Identify fencing operations in logs with the specified tag; use‐
103 ful when multiple entities might invoke stonith_admin (used with
104 most commands).
105
106 -v, --device=value
107 A device to associate with a given host and stonith level (with
108 --register-level).
109
110 -i, --index=value
111 The stonith level (1-9) (with --register-level, --deregis‐
112 ter-level).
113
114 -t, --timeout=value
115 Operation timeout in seconds (default 120; used with most com‐
116 mands).
117
118 -n, --as-node-id
119 (Advanced) The supplied node is the corosync node ID (with
120 --last).
121
122 --tolerance=value
123 (Advanced) Do nothing if an equivalent --fence request succeeded
124 less than this many seconds earlier (with --fence, --unfence,
125 --reboot).
126
128 Written by Andrew Beekhof
129
131 Report bugs to users@clusterlabs.org
132
133
134
135Pacemaker 1.1.18-3.el6 June 2018 PACEMAKER(8)