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

NAME

7       fence_emerson - Fence agent for Emerson over SNMP
8

DESCRIPTION

10       fence_emerson  is an I/O Fencing agent   which can be used with MPX and
11       MPH2 managed rack PDU.
12
13       fence_emerson accepts options on the  command  line  as  well  as  from
14       stdin.  Fenced  sends parameters through stdin when it execs the agent.
15       fence_emerson can be run by itself with command line options.  This  is
16       useful for testing and for turning outlets on or off from scripts.
17
18       Vendor URL: http://www.emersonnetworkpower.com
19

PARAMETERS

21
22
23       -o, --action=[action]
24              Fencing action (Default Value: reboot)
25
26       -c, --community=[community]
27              Set the community string
28
29       -a, --ip=[ip]
30              IP  address  or hostname of fencing device This parameter is al‐
31              ways required.
32
33       -u, --ipport=[port]
34              TCP/UDP port to use for connection with device  (Default  Value:
35              161)
36
37       -p, --password=[password]
38              Login password or passphrase
39
40       -S, --password-script=[script]
41              Script to run to retrieve password
42
43       -n, --plug=[id]
44              Physical  plug  number  on device, UUID or identification of ma‐
45              chine This parameter is always required.
46
47       -b, --snmp-auth-prot=[prot]
48              Set authentication protocol (MD5|SHA)
49
50       -P, --snmp-priv-passwd=[pass]
51              Set privacy protocol password
52
53       -R, --snmp-priv-passwd-script
54              Script to run to retrieve privacy password
55
56       -B, --snmp-priv-prot=[prot]
57              Set privacy protocol (DES|AES)
58
59       -E, --snmp-sec-level=[level]
60              Set security level (noAuthNoPriv|authNoPriv|authPriv)
61
62       -d, --snmp-version=[version]
63              Specifies SNMP version to use (1|2c|3)
64
65       -l, --username=[name]
66              Login name
67
68       -q, --quiet
69              Disable logging to stderr. Does not affect --verbose or --debug-
70              file or logging to syslog.
71
72       -v, --verbose
73              Verbose  mode.  Multiple  -v flags can be stacked on the command
74              line (e.g., -vvv) to increase verbosity.
75
76       --verbose-level
77              Level of debugging detail in output. Defaults to the  number  of
78              --verbose  flags  specified on the command line, or to 1 if ver‐
79              bose=1 in a  stonith  device  configuration  (i.e.,  on  stdin).
80
81
82       -D, --debug-file=[debugfile]
83              Write debug information to given file
84
85       -V, --version
86              Display version information and exit
87
88       -h, --help
89              Display help and exit
90
91       -C, --separator=[char]
92              Separator for CSV created by 'list' operation (Default Value: ,)
93
94
95       --delay=[seconds]
96              Wait X seconds before fencing  is  started  (Default  Value:  0)
97
98
99       --disable-timeout=[true/false]
100              Disable  timeout (true/false) (default: true when run from Pace‐
101              maker 2.0+)
102
103       --login-timeout=[seconds]
104              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
105
106
107       --power-timeout=[seconds]
108              Test  X  seconds  for status change after ON/OFF (Default Value:
109              20)
110
111       --power-wait=[seconds]
112              Wait X seconds after issuing ON/OFF (Default Value: 5)
113
114       --shell-timeout=[seconds]
115              Wait X seconds for cmd prompt  after  issuing  command  (Default
116              Value: 3)
117
118       --stonith-status-sleep=[seconds]
119              Sleep  X  seconds  between  status calls during a STONITH action
120              (Default Value: 1)
121
122       --retry-on=[attempts]
123              Count of attempts to retry power on (Default Value: 1)
124
125       --snmpget-path=[path]
126              Path to snmpget binary (Default Value: /usr/bin/snmpget)
127
128       --snmpset-path=[path]
129              Path to snmpset binary (Default Value: /usr/bin/snmpset)
130
131       --snmpwalk-path=[path]
132              Path to snmpwalk binary (Default Value: /usr/bin/snmpwalk)
133
134

ACTIONS

136
137
138       on     Power on machine.
139
140       off    Power off machine.
141
142       reboot Reboot machine.
143
144       status This returns the status of the plug/virtual machine.
145
146       list   List available plugs with aliases/virtual machines if  there  is
147              support for more then one device. Returns N/A otherwise.
148
149       list-status
150              List  available  plugs  with  aliases/virtual machines and their
151              power state if it can be obtained without  additional  commands.
152
153
154       monitor
155              Check the health of fence device
156
157       metadata
158              Display the XML metadata describing this resource.
159
160       manpage
161               The operational behavior of this is not known.
162
163       validate-all
164              Validate if all required parameters are entered.
165
166

STDIN PARAMETERS

168
169
170       action Fencing action (Default Value: reboot)
171
172       community
173              Set the community string
174
175       ip     IP  address  or hostname of fencing device This parameter is al‐
176              ways required. Obsoletes: ipaddr
177
178       ipport TCP/UDP port to use for connection with device  (Default  Value:
179              161)
180
181       password
182              Login password or passphrase Obsoletes: passwd
183
184       password_script
185              Script  to  run  to  retrieve  password Obsoletes: passwd_script
186
187
188       plug   Physical plug number on device, UUID or  identification  of  ma‐
189              chine  This  parameter is always required. Obsoletes: port
190
191
192       snmp_auth_prot
193              Set authentication protocol (MD5|SHA)
194
195       snmp_priv_passwd
196              Set privacy protocol password
197
198       snmp_priv_passwd_script
199              Script to run to retrieve privacy password
200
201       snmp_priv_prot
202              Set privacy protocol (DES|AES)
203
204       snmp_sec_level
205              Set security level (noAuthNoPriv|authNoPriv|authPriv)
206
207       snmp_version
208              Specifies SNMP version to use (1|2c|3)
209
210       username
211              Login name Obsoletes: login
212
213       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
214              file or logging to syslog.
215
216       verbose
217              Verbose  mode.  Multiple  -v flags can be stacked on the command
218              line (e.g., -vvv) to increase verbosity.
219
220       verbose_level
221              Level of debugging detail in output. Defaults to the  number  of
222              --verbose  flags  specified on the command line, or to 1 if ver‐
223              bose=1 in a  stonith  device  configuration  (i.e.,  on  stdin).
224
225
226       debug_file
227              Write debug information to given file Obsoletes: debug
228
229       version
230              Display version information and exit
231
232       help   Display help and exit
233
234       separator
235              Separator for CSV created by 'list' operation (Default Value: ,)
236
237
238       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
239
240
241       disable_timeout
242              Disable  timeout (true/false) (default: true when run from Pace‐
243              maker 2.0+)
244
245       login_timeout
246              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
247
248
249       power_timeout
250              Test  X  seconds  for status change after ON/OFF (Default Value:
251              20)
252
253       power_wait
254              Wait X seconds after issuing ON/OFF (Default Value: 5)
255
256       shell_timeout
257              Wait X seconds for cmd prompt  after  issuing  command  (Default
258              Value: 3)
259
260       stonith_status_sleep
261              Sleep  X  seconds  between  status calls during a STONITH action
262              (Default Value: 1)
263
264       retry_on
265              Count of attempts to retry power on (Default Value: 1)
266
267       snmpget_path
268              Path to snmpget binary (Default Value: /usr/bin/snmpget)
269
270       snmpset_path
271              Path to snmpset binary (Default Value: /usr/bin/snmpset)
272
273       snmpwalk_path
274              Path to snmpwalk binary (Default Value: /usr/bin/snmpwalk)
275
276
277
278fence_emerson (Fence Agent)       2009-10-20                    FENCE_AGENT(8)