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
31              always 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
45              machine 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       --retry-on=[attempts]
119              Count of attempts to retry power on (Default Value: 1)
120
121       --snmpget-path=[path]
122              Path to snmpget binary (Default Value: /usr/bin/snmpget)
123
124       --snmpset-path=[path]
125              Path to snmpset binary (Default Value: /usr/bin/snmpset)
126
127       --snmpwalk-path=[path]
128              Path to snmpwalk binary (Default Value: /usr/bin/snmpwalk)
129
130

ACTIONS

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

STDIN PARAMETERS

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