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

NAME

7       fence_eps - Fence agent for ePowerSwitch
8

DESCRIPTION

10       fence_eps   is  an I/O Fencing agent which can be used with the ePower‐
11       Switch 8M+ power switch to fence connected machines. Fence agent  works
12       ONLY  on  8M+  device,  because this is only one, which has support for
13       hidden page feature.
14
15       Agent basically works by connecting to hidden page and pass appropriate
16       arguments  to GET request. This means, that hidden page feature must be
17       enabled and properly configured.
18
19       fence_eps accepts options on the command line as well  as  from  stdin.
20       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
21       fence_eps can be run by itself with command line options.  This is use‐
22       ful for testing and for turning outlets on or off from scripts.
23
24       Vendor URL: http://www.epowerswitch.com
25

PARAMETERS

27
28
29       -o, --action=[action]
30              Fencing action (Default Value: reboot)
31
32       -a, --ip=[ip]
33              IP  address  or hostname of fencing device This parameter is al‐
34              ways required.
35
36       -u, --ipport=[port]
37              TCP/UDP port to use for connection with device  (Default  Value:
38              80)
39
40       -c, --page=[page]
41              Name  of  hidden  page  (Default  Value: hidden.htm)
42
43
44       -p, --password=[password]
45              Login password or passphrase
46
47       -S, --password-script=[script]
48              Script to run to retrieve password
49
50       -n, --plug=[id]
51              Physical plug number on device, UUID or  identification  of  ma‐
52              chine This parameter is always required.
53
54       -l, --username=[name]
55              Login name
56
57       -q, --quiet
58              Disable logging to stderr. Does not affect --verbose or --debug-
59              file or logging to syslog.
60
61       -v, --verbose
62              Verbose mode. Multiple -v flags can be stacked  on  the  command
63              line (e.g., -vvv) to increase verbosity.
64
65       --verbose-level
66              Level  of  debugging detail in output. Defaults to the number of
67              --verbose flags specified on the command line, or to 1  if  ver‐
68              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
69
70
71       -D, --debug-file=[debugfile]
72              Write debug information to given file
73
74       -V, --version
75              Display version information and exit
76
77       -h, --help
78              Display help and exit
79
80       --plug-separator=[char]
81              Separator for plug parameter when specifying more  than  1  plug
82              (Default Value: ,)
83
84       -C, --separator=[char]
85              Separator for CSV created by 'list' operation (Default Value: ,)
86
87
88       --delay=[seconds]
89              Wait X seconds before fencing  is  started  (Default  Value:  0)
90
91
92       --disable-timeout=[true/false]
93              Disable  timeout (true/false) (default: true when run from Pace‐
94              maker 2.0+)
95
96       --login-timeout=[seconds]
97              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
98
99
100       --power-timeout=[seconds]
101              Test  X  seconds  for status change after ON/OFF (Default Value:
102              20)
103
104       --power-wait=[seconds]
105              Wait X seconds after issuing ON/OFF (Default Value: 0)
106
107       --shell-timeout=[seconds]
108              Wait X seconds for cmd prompt  after  issuing  command  (Default
109              Value: 3)
110
111       --stonith-status-sleep=[seconds]
112              Sleep  X  seconds  between  status calls during a STONITH action
113              (Default Value: 1)
114
115       --retry-on=[attempts]
116              Count of attempts to retry power on (Default Value: 1)
117
118

ACTIONS

120
121
122       on     Power on machine.
123
124       off    Power off machine.
125
126       reboot Reboot machine.
127
128       status This returns the status of the plug/virtual machine.
129
130       list   List available plugs with aliases/virtual machines if  there  is
131              support for more then one device. Returns N/A otherwise.
132
133       list-status
134              List  available  plugs  with  aliases/virtual machines and their
135              power state if it can be obtained without  additional  commands.
136
137
138       monitor
139              Check the health of fence device
140
141       metadata
142              Display the XML metadata describing this resource.
143
144       manpage
145               The operational behavior of this is not known.
146
147       validate-all
148              Validate if all required parameters are entered.
149
150

STDIN PARAMETERS

152
153
154       action Fencing action (Default Value: reboot)
155
156       ip     IP  address  or hostname of fencing device This parameter is al‐
157              ways required. Obsoletes: ipaddr
158
159       ipport TCP/UDP port to use for connection with device  (Default  Value:
160              80)
161
162       page   Name  of hidden page (Default Value: hidden.htm) Obsoletes: hid‐
163              den_page
164
165       password
166              Login password or passphrase Obsoletes: passwd
167
168       password_script
169              Script to run  to  retrieve  password  Obsoletes:  passwd_script
170
171
172       plug   Physical  plug  number  on device, UUID or identification of ma‐
173              chine This parameter is always required. Obsoletes:  port
174
175
176       username
177              Login name Obsoletes: login
178
179       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
180              file or logging to syslog.
181
182       verbose
183              Verbose mode. Multiple -v flags can be stacked  on  the  command
184              line (e.g., -vvv) to increase verbosity.
185
186       verbose_level
187              Level  of  debugging detail in output. Defaults to the number of
188              --verbose flags specified on the command line, or to 1  if  ver‐
189              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
190
191
192       debug_file
193              Write debug information to given file Obsoletes: debug
194
195       version
196              Display version information and exit
197
198       help   Display help and exit
199
200       plug_separator
201              Separator for plug parameter when specifying more  than  1  plug
202              (Default Value: ,)
203
204       separator
205              Separator for CSV created by 'list' operation (Default Value: ,)
206
207
208       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
209
210
211       disable_timeout
212              Disable  timeout (true/false) (default: true when run from Pace‐
213              maker 2.0+)
214
215       login_timeout
216              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
217
218
219       power_timeout
220              Test  X  seconds  for status change after ON/OFF (Default Value:
221              20)
222
223       power_wait
224              Wait X seconds after issuing ON/OFF (Default Value: 0)
225
226       shell_timeout
227              Wait X seconds for cmd prompt  after  issuing  command  (Default
228              Value: 3)
229
230       stonith_status_sleep
231              Sleep  X  seconds  between  status calls during a STONITH action
232              (Default Value: 1)
233
234       retry_on
235              Count of attempts to retry power on (Default Value: 1)
236
237
238
239fence_eps (Fence Agent)           2009-10-20                    FENCE_AGENT(8)
Impressum