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       -c, --page=[page]
33              Name of hidden page (Default Value: hidden.htm)
34
35       -4, --inet4-only
36              Forces agent to use IPv4 addresses only
37
38       -6, --inet6-only
39              Forces agent to use IPv6 addresses only
40
41       -a, --ip=[ip]
42              IP Address or Hostname This parameter is always required.
43
44       -u, --ipport=[port]
45              TCP/UDP  port  to use for connection with device (Default Value:
46              80)
47
48       -l, --username=[name]
49              Login Name
50
51       -p, --password=[password]
52              Login password or passphrase
53
54       -S, --password-script=[script]
55              Script to retrieve password
56
57       -n, --plug=[id]
58              Physical plug number, name  of  virtual  machine  or  UUID  This
59              parameter is always required.
60
61       -v, --verbose
62              Verbose mode
63
64       -D, --debug-file=[debugfile]
65              Write debug information to given file
66
67       -V, --version
68              Display version information and exit
69
70       -h, --help
71              Display help and exit
72
73       -C, --separator=[char]
74              Separator  for  CSV created by operation list (Default Value: ,)
75
76
77       --delay=[seconds]
78              Wait X seconds before fencing  is  started  (Default  Value:  0)
79
80
81       --login-timeout=[seconds]
82              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
83
84
85       --power-timeout=[seconds]
86              Test X seconds for status change after  ON/OFF  (Default  Value:
87              20)
88
89       --power-wait=[seconds]
90              Wait X seconds after issuing ON/OFF (Default Value: 0)
91
92       --shell-timeout=[seconds]
93              Wait  X  seconds  for  cmd prompt after issuing command (Default
94              Value: 3)
95
96       --retry-on=[attempts]
97              Count of attempts to retry power on (Default Value: 1)
98
99

ACTIONS

101
102
103       on     Power on machine.
104
105       off    Power off machine.
106
107       reboot Reboot machine.
108
109       status This returns the status of the plug/virtual machine.
110
111       list   List available plugs with aliases/virtual machines if  there  is
112              support for more then one device. Returns N/A otherwise.
113
114       list-status
115              List  available  plugs  with  aliases/virtual machines and their
116              power state if it can be obtained without  additional  commands.
117
118
119       monitor
120              Check the health of fence device
121
122       metadata
123              Display the XML metadata describing this resource.
124
125

STDIN PARAMETERS

127
128
129       action Fencing Action (Default Value: reboot)
130
131       hidden_page
132              Name of hidden page (Default Value: hidden.htm)
133
134       inet4_only
135              Forces agent to use IPv4 addresses only
136
137       inet6_only
138              Forces agent to use IPv6 addresses only
139
140       ipaddr IP Address or Hostname This parameter is always required.
141
142       ipport TCP/UDP  port  to use for connection with device (Default Value:
143              80)
144
145       login  Login Name
146
147       passwd Login password or passphrase
148
149       passwd_script
150              Script to retrieve password
151
152       port   Physical plug number, name  of  virtual  machine  or  UUID  This
153              parameter is always required.
154
155       verbose
156              Verbose mode
157
158       debug  Write debug information to given file
159
160       version
161              Display version information and exit
162
163       help   Display help and exit
164
165       separator
166              Separator  for  CSV created by operation list (Default Value: ,)
167
168
169       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
170
171
172       login_timeout
173              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
174
175
176       power_timeout
177              Test X seconds for status change after  ON/OFF  (Default  Value:
178              20)
179
180       power_wait
181              Wait X seconds after issuing ON/OFF (Default Value: 0)
182
183       shell_timeout
184              Wait  X  seconds  for  cmd prompt after issuing command (Default
185              Value: 3)
186
187       retry_on
188              Count of attempts to retry power on (Default Value: 1)
189
190
191
192fence_eps (Fence Agent)           2009-10-20                    FENCE_AGENT(8)