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

ACTIONS

112
113
114       on     Power on machine.
115
116       off    Power off machine.
117
118       reboot Reboot machine.
119
120       status This returns the status of the plug/virtual machine.
121
122       list   List  available  plugs with aliases/virtual machines if there is
123              support for more then one device. Returns N/A otherwise.
124
125       list-status
126              List available plugs with  aliases/virtual  machines  and  their
127              power  state  if it can be obtained without additional commands.
128
129
130       monitor
131              Check the health of fence device
132
133       metadata
134              Display the XML metadata describing this resource.
135
136

STDIN PARAMETERS

138
139
140       action Fencing Action (Default Value: reboot)
141
142       community
143              Set the community string
144
145       inet4_only
146              Forces agent to use IPv4 addresses only
147
148       inet6_only
149              Forces agent to use IPv6 addresses only
150
151       ipaddr IP Address or Hostname This parameter is always required.
152
153       login  Login Name
154
155       passwd Login password or passphrase
156
157       passwd_script
158              Script to retrieve password
159
160       port   Physical plug number, name  of  virtual  machine  or  UUID  This
161              parameter is always required.
162
163       snmp_auth_prot
164              Set authentication protocol (MD5|SHA)
165
166       snmp_priv_passwd
167              Set privacy protocol password
168
169       snmp_priv_passwd_script
170              Script to run to retrieve privacy password
171
172       snmp_priv_prot
173              Set privacy protocol (DES|AES)
174
175       snmp_sec_level
176              Set security level (noAuthNoPriv|authNoPriv|authPriv)
177
178       snmp_version
179              Specifies SNMP version to use (1,2c,3)
180
181       udpport
182              UDP/TCP port to use for connection with device
183
184       verbose
185              Verbose mode
186
187       debug  Write debug information to given file
188
189       version
190              Display version information and exit
191
192       help   Display help and exit
193
194       separator
195              Separator  for  CSV created by operation list (Default Value: ,)
196
197
198       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
199
200
201       login_timeout
202              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
203
204
205       power_timeout
206              Test X seconds for status change after  ON/OFF  (Default  Value:
207              20)
208
209       power_wait
210              Wait X seconds after issuing ON/OFF (Default Value: 5)
211
212       shell_timeout
213              Wait  X  seconds  for  cmd prompt after issuing command (Default
214              Value: 3)
215
216       retry_on
217              Count of attempts to retry power on (Default Value: 1)
218
219
220
221fence_emerson (Fence Agent)       2009-10-20                    FENCE_AGENT(8)