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
11       another 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
20       options.   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
56              accounted 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       --retry-on=[attempts]
105              Count of attempts to retry power on (Default Value: 1)
106
107

ACTIONS

109
110
111       on     Power on machine.
112
113       off    Power off machine.
114
115       reboot Reboot machine.
116
117       monitor
118              Check the health of fence device
119
120       metadata
121              Display the XML metadata describing this resource.
122
123       manpage
124               The operational behavior of this is not known.
125
126       validate-all
127              Validate if all required parameters are entered.
128
129

STDIN PARAMETERS

131
132
133       action Fencing action (Default Value: reboot)
134
135       method Method to fence (onoff|cycle) (Default Value: cycle)
136
137       ping_count
138              The number of ping-probes that is being sent per target (Default
139              Value: 10)
140
141       ping_good_count
142              The  number of positive ping-probes required to account a target
143              as available (Default Value: 8)
144
145       ping_interval
146              The interval in seconds between ping-probes (Default  Value:  1)
147
148
149       ping_maxfail
150              The  number  of  failed ping-targets to still account as overall
151              success (Default Value: 0)
152
153       ping_targets
154              A comma separated list of ping-targets (optionally prepended  by
155              'inet:' or 'inet6:') to be probed (Default Value: )
156
157       ping_timeout
158              The   timeout  in  seconds  till  an  individual  ping-probe  is
159              accounted as lost (Default Value: 2)
160
161       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
162              file or logging to syslog.
163
164       verbose
165              Verbose  mode.  Multiple  -v flags can be stacked on the command
166              line (e.g., -vvv) to increase verbosity.
167
168       verbose_level
169              Level of debugging detail in output. Defaults to the  number  of
170              --verbose  flags  specified on the command line, or to 1 if ver‐
171              bose=1 in a  stonith  device  configuration  (i.e.,  on  stdin).
172
173
174       debug_file
175              Write debug information to given file Obsoletes: debug
176
177       version
178              Display version information and exit
179
180       help   Display help and exit
181
182       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
183
184
185       disable_timeout
186              Disable timeout (true/false) (default: true when run from  Pace‐
187              maker 2.0+)
188
189       login_timeout
190              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
191
192
193       power_timeout
194              Test X seconds for status change after  ON/OFF  (Default  Value:
195              20)
196
197       power_wait
198              Wait X seconds after issuing ON/OFF (Default Value: 0)
199
200       shell_timeout
201              Wait  X  seconds  for  cmd prompt after issuing command (Default
202              Value: 3)
203
204       retry_on
205              Count of attempts to retry power on (Default Value: 1)
206
207
208
209fence_heuristics_ping (Fence Agent)2009-10-20                    FENCE_AGENT(8)