1
2FENCE_AGENT(8) System Manager's Manual FENCE_AGENT(8)
3
4
5
7 fence_heuristics_ping - Fence agent for ping-heuristic based fencing
8
10 fence_heuristics_ping uses ping-heuristics to control execution of an‐
11 other fence agent on the same fencing level.
12
13 This is not a fence agent by itself! Its only purpose is to enable/dis‐
14 able another fence agent that lives on the same fencing level but after
15 fence_heuristics_ping.
16
17 fence_heuristics_ping accepts options on the command line as well as
18 from stdin. Fenced sends parameters through stdin when it execs the
19 agent. fence_heuristics_ping can be run by itself with command line op‐
20 tions. This is useful for testing and for turning outlets on or off
21 from scripts.
22
23 Vendor URL:
24
26
27
28 -o, --action=[action]
29 Fencing action (Default Value: reboot)
30
31 -m, --method=[method]
32 Method to fence (onoff|cycle) (Default Value: cycle)
33
34 --ping-count=[number]
35 The number of ping-probes that is being sent per target (Default
36 Value: 10)
37
38 --ping-good-count=[number]
39 The number of positive ping-probes required to account a target
40 as available (Default Value: 8)
41
42 --ping-interval=[seconds]
43 The interval in seconds between ping-probes (Default Value: 1)
44
45
46 --ping-maxfail=[number]
47 The number of failed ping-targets to still account as overall
48 success (Default Value: 0)
49
50 --ping-targets=tgt1,[inet6:]tgt2
51 A comma separated list of ping-targets (optionally prepended by
52 'inet:' or 'inet6:') to be probed (Default Value: )
53
54 --ping-timeout=[seconds]
55 The timeout in seconds till an individual ping-probe is ac‐
56 counted as lost (Default Value: 2)
57
58 -q, --quiet
59 Disable logging to stderr. Does not affect --verbose or --debug-
60 file or logging to syslog.
61
62 -v, --verbose
63 Verbose mode. Multiple -v flags can be stacked on the command
64 line (e.g., -vvv) to increase verbosity.
65
66 --verbose-level
67 Level of debugging detail in output. Defaults to the number of
68 --verbose flags specified on the command line, or to 1 if ver‐
69 bose=1 in a stonith device configuration (i.e., on stdin).
70
71
72 -D, --debug-file=[debugfile]
73 Write debug information to given file
74
75 -V, --version
76 Display version information and exit
77
78 -h, --help
79 Display help and exit
80
81 --delay=[seconds]
82 Wait X seconds before fencing is started (Default Value: 0)
83
84
85 --disable-timeout=[true/false]
86 Disable timeout (true/false) (default: true when run from Pace‐
87 maker 2.0+)
88
89 --login-timeout=[seconds]
90 Wait X seconds for cmd prompt after login (Default Value: 5)
91
92
93 --power-timeout=[seconds]
94 Test X seconds for status change after ON/OFF (Default Value:
95 20)
96
97 --power-wait=[seconds]
98 Wait X seconds after issuing ON/OFF (Default Value: 0)
99
100 --shell-timeout=[seconds]
101 Wait X seconds for cmd prompt after issuing command (Default
102 Value: 3)
103
104 --stonith-status-sleep=[seconds]
105 Sleep X seconds between status calls during a STONITH action
106 (Default Value: 1)
107
108 --retry-on=[attempts]
109 Count of attempts to retry power on (Default Value: 1)
110
111
113
114
115 on Power on machine.
116
117 off Power off machine.
118
119 reboot Reboot machine.
120
121 monitor
122 Check the health of fence device
123
124 metadata
125 Display the XML metadata describing this resource.
126
127 manpage
128 The operational behavior of this is not known.
129
130 validate-all
131 Validate if all required parameters are entered.
132
133
135
136
137 action Fencing action (Default Value: reboot)
138
139 method Method to fence (onoff|cycle) (Default Value: cycle)
140
141 ping_count
142 The number of ping-probes that is being sent per target (Default
143 Value: 10)
144
145 ping_good_count
146 The number of positive ping-probes required to account a target
147 as available (Default Value: 8)
148
149 ping_interval
150 The interval in seconds between ping-probes (Default Value: 1)
151
152
153 ping_maxfail
154 The number of failed ping-targets to still account as overall
155 success (Default Value: 0)
156
157 ping_targets
158 A comma separated list of ping-targets (optionally prepended by
159 'inet:' or 'inet6:') to be probed (Default Value: )
160
161 ping_timeout
162 The timeout in seconds till an individual ping-probe is ac‐
163 counted as lost (Default Value: 2)
164
165 quiet Disable logging to stderr. Does not affect --verbose or --debug-
166 file or logging to syslog.
167
168 verbose
169 Verbose mode. Multiple -v flags can be stacked on the command
170 line (e.g., -vvv) to increase verbosity.
171
172 verbose_level
173 Level of debugging detail in output. Defaults to the number of
174 --verbose flags specified on the command line, or to 1 if ver‐
175 bose=1 in a stonith device configuration (i.e., on stdin).
176
177
178 debug_file
179 Write debug information to given file Obsoletes: debug
180
181 version
182 Display version information and exit
183
184 help Display help and exit
185
186 delay Wait X seconds before fencing is started (Default Value: 0)
187
188
189 disable_timeout
190 Disable timeout (true/false) (default: true when run from Pace‐
191 maker 2.0+)
192
193 login_timeout
194 Wait X seconds for cmd prompt after login (Default Value: 5)
195
196
197 power_timeout
198 Test X seconds for status change after ON/OFF (Default Value:
199 20)
200
201 power_wait
202 Wait X seconds after issuing ON/OFF (Default Value: 0)
203
204 shell_timeout
205 Wait X seconds for cmd prompt after issuing command (Default
206 Value: 3)
207
208 stonith_status_sleep
209 Sleep X seconds between status calls during a STONITH action
210 (Default Value: 1)
211
212 retry_on
213 Count of attempts to retry power on (Default Value: 1)
214
215
216
217fence_heuristics_ping (Fence Agent)2009-10-20 FENCE_AGENT(8)