1FENCE_AGENT(8) System Manager's Manual FENCE_AGENT(8)
3
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 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 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 Vendor URL:
24
26 -o, --action=[action]
29 Fencing action (Default Value: reboot)
30 -m, --method=[method]
32 Method to fence (onoff|cycle) (Default Value: cycle)
33 --ping-count=[number]
35 The number of ping-probes that is being sent per target (Default
36 Value: 10)
37 --ping-good-count=[number]
39 The number of positive ping-probes required to account a target
40 as available (Default Value: 8)
41 --ping-interval=[seconds]
43 The interval in seconds between ping-probes (Default Value: 1)
44 --ping-maxfail=[number]
47 The number of failed ping-targets to still account as overall
48 success (Default Value: 0)
49 --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 --ping-timeout=[seconds]
55 The timeout in seconds till an individual ping-probe is ac‐
56 counted as lost (Default Value: 2)
57 -q, --quiet
59 Disable logging to stderr. Does not affect --verbose or --debug-
60 file or logging to syslog.
61 -v, --verbose
63 Verbose mode. Multiple -v flags can be stacked on the command
64 line (e.g., -vvv) to increase verbosity.
65 --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 -D, --debug-file=[debugfile]
73 Write debug information to given file
74 -V, --version
76 Display version information and exit
77 -h, --help
79 Display help and exit
80 --plug-separator=[char]
82 Separator for plug parameter when specifying more than 1 plug
83 (Default Value: ,)
84 --delay=[seconds]
86 Wait X seconds before fencing is started (Default Value: 0)
87 --disable-timeout=[true/false]
90 Disable timeout (true/false) (default: true when run from Pace‐
91 maker 2.0+)
92 --login-timeout=[seconds]
94 Wait X seconds for cmd prompt after login (Default Value: 5)
95 --power-timeout=[seconds]
98 Test X seconds for status change after ON/OFF (Default Value:
99 20)
100 --power-wait=[seconds]
102 Wait X seconds after issuing ON/OFF (Default Value: 0)
103 --shell-timeout=[seconds]
105 Wait X seconds for cmd prompt after issuing command (Default
106 Value: 3)
107 --stonith-status-sleep=[seconds]
109 Sleep X seconds between status calls during a STONITH action
110 (Default Value: 1)
111 --retry-on=[attempts]
113 Count of attempts to retry power on (Default Value: 1)
114
117 on Power on machine.
120 off Power off machine.
122 reboot Reboot machine.
124 monitor
126 Check the health of fence device
127 metadata
129 Display the XML metadata describing this resource.
130 manpage
132 The operational behavior of this is not known.
133 validate-all
135 Validate if all required parameters are entered.
136
139 action Fencing action (Default Value: reboot)
142 method Method to fence (onoff|cycle) (Default Value: cycle)
144 ping_count
146 The number of ping-probes that is being sent per target (Default
147 Value: 10)
148 ping_good_count
150 The number of positive ping-probes required to account a target
151 as available (Default Value: 8)
152 ping_interval
154 The interval in seconds between ping-probes (Default Value: 1)
155 ping_maxfail
158 The number of failed ping-targets to still account as overall
159 success (Default Value: 0)
160 ping_targets
162 A comma separated list of ping-targets (optionally prepended by
163 'inet:' or 'inet6:') to be probed (Default Value: )
164 ping_timeout
166 The timeout in seconds till an individual ping-probe is ac‐
167 counted as lost (Default Value: 2)
168 quiet Disable logging to stderr. Does not affect --verbose or --debug-
170 file or logging to syslog.
171 verbose
173 Verbose mode. Multiple -v flags can be stacked on the command
174 line (e.g., -vvv) to increase verbosity.
175 verbose_level
177 Level of debugging detail in output. Defaults to the number of
178 --verbose flags specified on the command line, or to 1 if ver‐
179 bose=1 in a stonith device configuration (i.e., on stdin).
180 debug_file
183 Write debug information to given file Obsoletes: debug
184 version
186 Display version information and exit
187 help Display help and exit
189 plug_separator
191 Separator for plug parameter when specifying more than 1 plug
192 (Default Value: ,)
193 delay Wait X seconds before fencing is started (Default Value: 0)
195 disable_timeout
198 Disable timeout (true/false) (default: true when run from Pace‐
199 maker 2.0+)
200 login_timeout
202 Wait X seconds for cmd prompt after login (Default Value: 5)
203 power_timeout
206 Test X seconds for status change after ON/OFF (Default Value:
207 20)
208 power_wait
210 Wait X seconds after issuing ON/OFF (Default Value: 0)
211 shell_timeout
213 Wait X seconds for cmd prompt after issuing command (Default
214 Value: 3)
215 stonith_status_sleep
217 Sleep X seconds between status calls during a STONITH action
218 (Default Value: 1)
219 retry_on
221 Count of attempts to retry power on (Default Value: 1)
222fence_heuristics_ping (Fence Agent)2009-10-20 FENCE_AGENT(8)