fence_heuristics_ping(8)

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
64
65       -D, --debug-file=[debugfile]
66              Write debug information to given file
67
68       -V, --version
69              Display version information and exit
70
71       -h, --help
72              Display help and exit
73
74       --delay=[seconds]
75              Wait  X  seconds  before  fencing  is started (Default Value: 0)
76
77
78       --login-timeout=[seconds]
79              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
80
81
82       --power-timeout=[seconds]
83              Test  X  seconds  for status change after ON/OFF (Default Value:
84              20)
85
86       --power-wait=[seconds]
87              Wait X seconds after issuing ON/OFF (Default Value: 0)
88
89       --shell-timeout=[seconds]
90              Wait X seconds for cmd prompt  after  issuing  command  (Default
91              Value: 3)
92
93       --retry-on=[attempts]
94              Count of attempts to retry power on (Default Value: 1)
95
96

ACTIONS

98
99
100       on     Power on machine.
101
102       off    Power off machine.
103
104       reboot Reboot machine.
105
106       monitor
107              Check the health of fence device
108
109       metadata
110              Display the XML metadata describing this resource.
111
112       manpage
113               The operational behavior of this is not known.
114
115       validate-all
116              Validate if all required parameters are entered.
117
118

STDIN PARAMETERS

120
121
122       action Fencing action (Default Value: reboot)
123
124       method Method to fence (onoff|cycle) (Default Value: cycle)
125
126       ping_count
127              The number of ping-probes that is being sent per target (Default
128              Value: 10)
129
130       ping_good_count
131              The number of positive ping-probes required to account a  target
132              as available (Default Value: 8)
133
134       ping_interval
135              The  interval  in seconds between ping-probes (Default Value: 1)
136
137
138       ping_maxfail
139              The number of failed ping-targets to still  account  as  overall
140              success (Default Value: 0)
141
142       ping_targets
143              A  comma separated list of ping-targets (optionally prepended by
144              'inet:' or 'inet6:') to be probed (Default Value: )
145
146       ping_timeout
147              The  timeout  in  seconds  till  an  individual  ping-probe   is
148              accounted as lost (Default Value: 2)
149
150       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
151              file or logging to syslog.
152
153       verbose
154              Verbose mode
155
156       debug_file
157              Write debug information to given file Obsoletes: debug
158
159       version
160              Display version information and exit
161
162       help   Display help and exit
163
164       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
165
166
167       login_timeout
168              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
169
170
171       power_timeout
172              Test X seconds for status change after  ON/OFF  (Default  Value:
173              20)
174
175       power_wait
176              Wait X seconds after issuing ON/OFF (Default Value: 0)
177
178       shell_timeout
179              Wait  X  seconds  for  cmd prompt after issuing command (Default
180              Value: 3)
181
182       retry_on
183              Count of attempts to retry power on (Default Value: 1)
184
185
186
187fence_heuristics_ping (Fence Agent)2009-10-20                    FENCE_AGENT(8)