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

ACTIONS

114
115
116       on     Power on machine.
117
118       off    Power off machine.
119
120       reboot Reboot machine.
121
122       status This returns the status of the plug/virtual machine.
123
124       list   List  available  plugs with aliases/virtual machines if there is
125              support for more then one device. Returns N/A otherwise.
126
127       monitor
128              Check if fencing device is running. List available plugs/virtual
129              machines or get status of machine (if it does not support more).
130
131
132       metadata
133               The operational behavior of this is not known.
134
135

STDIN PARAMETERS

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