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

ACTIONS

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

STDIN PARAMETERS

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