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 This parameter is always required.
34
35       -l, --username=<name>
36              Login Name
37
38       -p, --password=<password>
39              Login password or passphrase
40
41       -S, --password-script=<script>
42              Script to retrieve password
43
44       -n, --plug=<id>
45              Physical  plug  number or name of virtual machine This parameter
46              is always required.
47
48       -c, --page=<page>
49              Name of hidden page (Default Value: hidden.htm)
50
51       -v, --verbose
52              Verbose mode
53
54       -D, --debug-file=<debugfile>
55              Write debug information to given file
56
57       -V, --version
58              Display version information and exit
59
60       -h, --help
61              Display help and exit
62
63       -C, --separator=<char>
64              Separator for CSV created by operation list (Default  Value:  ,)
65
66
67       --delay
68              Wait  X  seconds  before  fencing  is started (Default Value: 0)
69
70
71       --retry-on
72              Count of attempts to retry power on (Default Value: 1)
73
74

ACTIONS

76
77
78       on     Power on machine.
79
80       off    Power off machine.
81
82       reboot Reboot machine.
83
84       status This returns the status of the plug/virtual machine.
85
86       list   List available plugs with aliases/virtual machines if  there  is
87              support for more then one device. Returns N/A otherwise.
88
89       monitor
90              Check if fencing device is running. List available plugs/virtual
91              machines or get status of machine (if it does not support more).
92
93
94       metadata
95               The operational behavior of this is not known.
96
97

STDIN PARAMETERS

99
100
101       action Fencing Action (Default Value: reboot)
102
103       ipaddr IP Address or Hostname This parameter is always required.
104
105       login  Login Name
106
107       passwd Login password or passphrase
108
109       passwd_script
110              Script to retrieve password
111
112       port   Physical  plug  number or name of virtual machine This parameter
113              is always required.
114
115       hidden_page
116              Name of hidden page (Default Value: hidden.htm)
117
118       verbose
119              Verbose mode
120
121       debug  Write debug information to given file
122
123       version
124              Display version information and exit
125
126       help   Display help and exit
127
128       separator
129              Separator for CSV created by operation list (Default  Value:  ,)
130
131
132       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
133
134
135       retry_on
136              Count of attempts to retry power on (Default Value: 1)
137
138
139
140fence_eps (Fence Agent)           2009-10-20                    FENCE_AGENT(8)