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

NAME

7       fence_bladecenter - Fence agent for IBM BladeCenter
8

DESCRIPTION

10       fence_bladecenter  is  an  I/O Fencing agent which can be used with IBM
11       Bladecenters with recent enough firmware that includes telnet  support.
12       It  logs  into  a Brocade chasis via telnet or ssh and uses the command
13       line interface to power on and off blades.
14
15       fence_bladecenter accepts options on the command line as well  as  from
16       stdin.  Fenced  sends parameters through stdin when it execs the agent.
17       fence_bladecenter can be run by itself with command line options.  This
18       is useful for testing and for turning outlets on or off from scripts.
19
20       Vendor URL: http://www.ibm.com
21

PARAMETERS

23
24
25       -o, --action=<action>
26              Fencing Action (Default Value: reboot)
27
28       -a, --ip=<ip>
29              IP Address or Hostname This parameter is always required.
30
31       -l, --username=<name>
32              Login Name This parameter is always required.
33
34       -p, --password=<password>
35              Login password or passphrase
36
37       -S, --password-script=<script>
38              Script to retrieve password
39
40       -c, --command-prompt=<prompt>
41              Force command prompt (Default Value: system>)
42
43       -x, --ssh
44              SSH connection
45
46       -n, --plug=<id>
47              Physical  plug  number or name of virtual machine This parameter
48              is always required.
49
50       -k, --identity-file=<filename>
51              Identity file for ssh
52
53       -4, --inet4-only
54              Forces agent to use IPv4 addresses only
55
56       -6, --inet6-only
57              Forces agent to use IPv6 addresses only
58
59       -u, --ipport=<port>
60              TCP port to use for connection with device
61
62       -v, --verbose
63              Verbose mode
64
65       -D, --debug-file=<debugfile>
66              Write debug information to given file
67
68       -V, --version
69              Display version information and exit
70
71       -h, --help
72              Display help and exit
73
74       -C, --separator=<char>
75              Separator for CSV created by operation list (Default  Value:  ,)
76
77
78       --power-timeout
79              Test  X  seconds  for status change after ON/OFF (Default Value:
80              20)
81
82       --shell-timeout
83              Wait X seconds for cmd prompt  after  issuing  command  (Default
84              Value: 3)
85
86       --login-timeout
87              Wait  X  seconds  for  cmd prompt after login (Default Value: 5)
88
89
90       --power-wait
91              Wait X seconds after issuing ON/OFF (Default Value: 10)
92
93       --missing-as-off
94              Missing port returns OFF instead of failure
95
96       --delay
97              Wait X seconds before fencing  is  started  (Default  Value:  0)
98
99
100       --retry-on
101              Count of attempts to retry power on (Default Value: 1)
102
103

ACTIONS

105
106
107       on     Power on machine.
108
109       off    Power off machine.
110
111       reboot Reboot machine.
112
113       status This returns the status of the plug/virtual machine.
114
115       list   List  available  plugs with aliases/virtual machines if there is
116              support for more then one device. Returns N/A otherwise.
117
118       monitor
119              Check if fencing device is running. List available plugs/virtual
120              machines or get status of machine (if it does not support more).
121
122
123       metadata
124               The operational behavior of this is not known.
125
126

STDIN PARAMETERS

128
129
130       action Fencing Action (Default Value: reboot)
131
132       ipaddr IP Address or Hostname This parameter is always required.
133
134       login  Login Name This parameter is always required.
135
136       passwd Login password or passphrase
137
138       passwd_script
139              Script to retrieve password
140
141       cmd_prompt
142              Force command prompt (Default Value: system>)
143
144       secure SSH connection
145
146       port   Physical plug number or name of virtual machine  This  parameter
147              is always required.
148
149       identity_file
150              Identity file for ssh
151
152       inet4_only
153              Forces agent to use IPv4 addresses only
154
155       inet6_only
156              Forces agent to use IPv6 addresses only
157
158       ipport TCP port to use for connection with device
159
160       verbose
161              Verbose mode
162
163       debug  Write debug information to given file
164
165       version
166              Display version information and exit
167
168       help   Display help and exit
169
170       separator
171              Separator  for  CSV created by operation list (Default Value: ,)
172
173
174       power_timeout
175              Test X seconds for status change after  ON/OFF  (Default  Value:
176              20)
177
178       shell_timeout
179              Wait  X  seconds  for  cmd prompt after issuing command (Default
180              Value: 3)
181
182       login_timeout
183              Wait X seconds for cmd prompt after  login  (Default  Value:  5)
184
185
186       power_wait
187              Wait X seconds after issuing ON/OFF (Default Value: 10)
188
189       missing_as_off
190              Missing port returns OFF instead of failure
191
192       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
193
194
195       retry_on
196              Count of attempts to retry power on (Default Value: 1)
197
198
199
200fence_bladecenter (Fence Agent)   2009-10-20                    FENCE_AGENT(8)