1
2FENCE_AGENT(8)              System Manager's Manual             FENCE_AGENT(8)
3
4
5

NAME

7       fence_heuristics_ping - Fence agent for ping-heuristic based fencing
8

DESCRIPTION

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

PARAMETERS

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

ACTIONS

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

STDIN PARAMETERS

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)
Impressum