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
34              always 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
52              machine 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       -C, --separator=[char]
81              Separator for CSV created by 'list' operation (Default Value: ,)
82
83
84       --delay=[seconds]
85              Wait  X  seconds  before  fencing  is started (Default Value: 0)
86
87
88       --disable-timeout=[true/false]
89              Disable timeout (true/false) (default: true when run from  Pace‐
90              maker 2.0+)
91
92       --login-timeout=[seconds]
93              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
94
95
96       --power-timeout=[seconds]
97              Test X seconds for status change after  ON/OFF  (Default  Value:
98              20)
99
100       --power-wait=[seconds]
101              Wait X seconds after issuing ON/OFF (Default Value: 0)
102
103       --shell-timeout=[seconds]
104              Wait  X  seconds  for  cmd prompt after issuing command (Default
105              Value: 3)
106
107       --retry-on=[attempts]
108              Count of attempts to retry power on (Default Value: 1)
109
110

ACTIONS

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

STDIN PARAMETERS

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