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

NAME

7       fence_ibmblade - Fence agent for IBM BladeCenter over SNMP
8

DESCRIPTION

10       fence_ibmblade  is  an  I/O  Fencing  agent  which can be used with IBM
11       BladeCenter chassis. It issues SNMP Set request to BladeCenter chassis,
12       rebooting, powering up or down the specified Blade Server.
13
14       fence_ibmblade  accepts  options  on  the  command line as well as from
15       stdin. Fenced sends parameters through stdin when it execs  the  agent.
16       fence_ibmblade can be run by itself with command line options.  This is
17       useful for testing and for turning outlets on or off from scripts.
18
19       Vendor URL: http://www.ibm.com
20

PARAMETERS

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

ACTIONS

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

STDIN PARAMETERS

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