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