1FENCE_AGENT(8) System Manager's Manual FENCE_AGENT(8)
3
7 fence_eps - Fence agent for ePowerSwitch
8
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 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 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 Vendor URL: http://www.epowerswitch.com
25
27 -o, --action=[action]
30 Fencing action (Default Value: reboot)
31 -a, --ip=[ip]
33 IP address or hostname of fencing device This parameter is al‐
34 ways required.
35 -u, --ipport=[port]
37 TCP/UDP port to use for connection with device (Default Value:
38 80)
39 -c, --page=[page]
41 Name of hidden page (Default Value: hidden.htm)
42 -p, --password=[password]
45 Login password or passphrase
46 -S, --password-script=[script]
48 Script to run to retrieve password
49 -n, --plug=[id]
51 Physical plug number on device, UUID or identification of ma‐
52 chine This parameter is always required.
53 -l, --username=[name]
55 Login name
56 -q, --quiet
58 Disable logging to stderr. Does not affect --verbose or --debug-
59 file or logging to syslog.
60 -v, --verbose
62 Verbose mode. Multiple -v flags can be stacked on the command
63 line (e.g., -vvv) to increase verbosity.
64 --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 -D, --debug-file=[debugfile]
72 Write debug information to given file
73 -V, --version
75 Display version information and exit
76 -h, --help
78 Display help and exit
79 --plug-separator=[char]
81 Separator for plug parameter when specifying more than 1 plug
82 (Default Value: ,)
83 -C, --separator=[char]
85 Separator for CSV created by 'list' operation (Default Value: ,)
86 --delay=[seconds]
89 Wait X seconds before fencing is started (Default Value: 0)
90 --disable-timeout=[true/false]
93 Disable timeout (true/false) (default: true when run from Pace‐
94 maker 2.0+)
95 --login-timeout=[seconds]
97 Wait X seconds for cmd prompt after login (Default Value: 5)
98 --power-timeout=[seconds]
101 Test X seconds for status change after ON/OFF (Default Value:
102 20)
103 --power-wait=[seconds]
105 Wait X seconds after issuing ON/OFF (Default Value: 0)
106 --shell-timeout=[seconds]
108 Wait X seconds for cmd prompt after issuing command (Default
109 Value: 3)
110 --stonith-status-sleep=[seconds]
112 Sleep X seconds between status calls during a STONITH action
113 (Default Value: 1)
114 --retry-on=[attempts]
116 Count of attempts to retry power on (Default Value: 1)
117
120 on Power on machine.
123 off Power off machine.
125 reboot Reboot machine.
127 status This returns the status of the plug/virtual machine.
129 list List available plugs with aliases/virtual machines if there is
131 support for more then one device. Returns N/A otherwise.
132 list-status
134 List available plugs with aliases/virtual machines and their
135 power state if it can be obtained without additional commands.
136 monitor
139 Check the health of fence device
140 metadata
142 Display the XML metadata describing this resource.
143 manpage
145 The operational behavior of this is not known.
146 validate-all
148 Validate if all required parameters are entered.
149
152 action Fencing action (Default Value: reboot)
155 ip IP address or hostname of fencing device This parameter is al‐
157 ways required. Obsoletes: ipaddr
158 ipport TCP/UDP port to use for connection with device (Default Value:
160 80)
161 page Name of hidden page (Default Value: hidden.htm) Obsoletes: hid‐
163 den_page
164 password
166 Login password or passphrase Obsoletes: passwd
167 password_script
169 Script to run to retrieve password Obsoletes: passwd_script
170 plug Physical plug number on device, UUID or identification of ma‐
173 chine This parameter is always required. Obsoletes: port
174 username
177 Login name Obsoletes: login
178 quiet Disable logging to stderr. Does not affect --verbose or --debug-
180 file or logging to syslog.
181 verbose
183 Verbose mode. Multiple -v flags can be stacked on the command
184 line (e.g., -vvv) to increase verbosity.
185 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 debug_file
193 Write debug information to given file Obsoletes: debug
194 version
196 Display version information and exit
197 help Display help and exit
199 plug_separator
201 Separator for plug parameter when specifying more than 1 plug
202 (Default Value: ,)
203 separator
205 Separator for CSV created by 'list' operation (Default Value: ,)
206 delay Wait X seconds before fencing is started (Default Value: 0)
209 disable_timeout
212 Disable timeout (true/false) (default: true when run from Pace‐
213 maker 2.0+)
214 login_timeout
216 Wait X seconds for cmd prompt after login (Default Value: 5)
217 power_timeout
220 Test X seconds for status change after ON/OFF (Default Value:
221 20)
222 power_wait
224 Wait X seconds after issuing ON/OFF (Default Value: 0)
225 shell_timeout
227 Wait X seconds for cmd prompt after issuing command (Default
228 Value: 3)
229 stonith_status_sleep
231 Sleep X seconds between status calls during a STONITH action
232 (Default Value: 1)
233 retry_on
235 Count of attempts to retry power on (Default Value: 1)
236fence_eps (Fence Agent) 2009-10-20 FENCE_AGENT(8)