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

NAME

7       fence_ilo - Fence agent for HP iLO
8
9       fence_ilo2 - Fence agent for HP iLO2 (symlink)
10
11

DESCRIPTION

13       fence_ilo  is  an  I/O Fencing agent used for HP servers with the Inte‐
14       grated Light Out (iLO) PCI card.The agent opens an  SSL  connection  to
15       the iLO card. Once the SSL connection is established, the agent is able
16       to communicate with the iLO card through an XML stream.
17
18       fence_ilo accepts options on the command line as well  as  from  stdin.
19       Fenced  sends  parameters  through  stdin  when  it  execs  the  agent.
20       fence_ilo can be run by itself with command line options.  This is use‐
21       ful for testing and for turning outlets on or off from scripts.
22
23       Vendor URL: http://www.hp.com
24

PARAMETERS

26
27
28       -o, --action=[action]
29              Fencing action (Default Value: reboot)
30
31       -a, --ip=[ip]
32              IP address or hostname of fencing device
33
34       -u, --ipport=[port]
35              TCP/UDP  port  to use for connection with device (Default Value:
36              443)
37
38       -t, --notls
39              Disable TLS negotiation and force SSL3.0. This  should  only  be
40              used for devices that do not support TLS1.0 and up.
41
42
43       -p, --password=[password]
44              Login password or passphrase
45
46       -S, --password-script=[script]
47              Script to run to retrieve password
48
49       -n, --plug=[ip]
50              IP address or hostname of fencing device (together with  --port-
51              as-ip)
52
53       -r, --ribcl-version=[version]
54              Force ribcl version to use
55
56       -z, --ssl
57              Use SSL connection with verifying certificate (Default Value: 1)
58
59
60       --ssl-insecure
61              Use SSL connection without verifying certificate
62
63       --ssl-secure
64              Use SSL connection with verifying certificate
65
66       --tls1.0
67              Disable TLS negotiation and force TLS1.0. This  should  only  be
68              used for devices that do not support TLS1.1 and up.
69
70       -l, --username=[name]
71              Login name This parameter is always required.
72
73       -q, --quiet
74              Disable logging to stderr. Does not affect --verbose or --debug-
75              file or logging to syslog.
76
77       -v, --verbose
78              Verbose mode. Multiple -v flags can be stacked  on  the  command
79              line (e.g., -vvv) to increase verbosity.
80
81       --verbose-level
82              Level  of  debugging detail in output. Defaults to the number of
83              --verbose flags specified on the command line, or to 1  if  ver‐
84              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
85
86
87       -D, --debug-file=[debugfile]
88              Write debug information to given file
89
90       -V, --version
91              Display version information and exit
92
93       -h, --help
94              Display help and exit
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:  10)
106
107
108       --port-as-ip
109              Make "port/plug" to be an alias to IP address
110
111       --power-timeout=[seconds]
112              Test  X  seconds  for status change after ON/OFF (Default Value:
113              20)
114
115       --power-wait=[seconds]
116              Wait X seconds after issuing ON/OFF (Default Value: 0)
117
118       --shell-timeout=[seconds]
119              Wait X seconds for cmd prompt  after  issuing  command  (Default
120              Value: 3)
121
122       --stonith-status-sleep=[seconds]
123              Sleep  X  seconds  between  status calls during a STONITH action
124              (Default Value: 1)
125
126       --retry-on=[attempts]
127              Count of attempts to retry power on (Default Value: 3)
128
129       --gnutlscli-path=[path]
130              Path to gnutls-cli binary (Default Value: /usr/bin/gnutls-cli)
131
132

ACTIONS

134
135
136       on     Power on machine.
137
138       off    Power off machine.
139
140       reboot Reboot machine.
141
142       status This returns the status of the plug/virtual machine.
143
144       monitor
145              Check the health of fence device
146
147       metadata
148              Display the XML metadata describing this resource.
149
150       manpage
151               The operational behavior of this is not known.
152
153       validate-all
154              Validate if all required parameters are entered.
155
156

STDIN PARAMETERS

158
159
160       action Fencing action (Default Value: reboot)
161
162       ip     IP address or hostname of fencing device Obsoletes: ipaddr
163
164
165       ipport TCP/UDP  port  to use for connection with device (Default Value:
166              443)
167
168       notls  Disable TLS negotiation and force SSL3.0. This  should  only  be
169              used for devices that do not support TLS1.0 and up.
170
171
172       password
173              Login password or passphrase Obsoletes: passwd
174
175       password_script
176              Script to run  to  retrieve  password  Obsoletes:  passwd_script
177
178
179       plug   IP  address or hostname of fencing device (together with --port-
180              as-ip) Obsoletes: port
181
182       ribcl_version
183              Force ribcl version to use Obsoletes: ribcl
184
185       ssl    Use SSL connection with verifying certificate (Default Value: 1)
186
187
188       ssl_insecure
189              Use SSL connection without verifying certificate
190
191       ssl_secure
192              Use SSL connection with verifying certificate
193
194       tls1.0 Disable  TLS  negotiation  and force TLS1.0. This should only be
195              used for devices that do not support TLS1.1 and up.
196
197       username
198              Login name This parameter is always required.  Obsoletes:  login
199
200
201       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
202              file or logging to syslog.
203
204       verbose
205              Verbose mode. Multiple -v flags can be stacked  on  the  command
206              line (e.g., -vvv) to increase verbosity.
207
208       verbose_level
209              Level  of  debugging detail in output. Defaults to the number of
210              --verbose flags specified on the command line, or to 1  if  ver‐
211              bose=1  in  a  stonith  device  configuration  (i.e., on stdin).
212
213
214       debug_file
215              Write debug information to given file Obsoletes: debug
216
217       version
218              Display version information and exit
219
220       help   Display help and exit
221
222       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
223
224
225       disable_timeout
226              Disable  timeout (true/false) (default: true when run from Pace‐
227              maker 2.0+)
228
229       login_timeout
230              Wait X seconds for cmd prompt after login  (Default  Value:  10)
231
232
233       port_as_ip
234              Make "port/plug" to be an alias to IP address
235
236       power_timeout
237              Test  X  seconds  for status change after ON/OFF (Default Value:
238              20)
239
240       power_wait
241              Wait X seconds after issuing ON/OFF (Default Value: 0)
242
243       shell_timeout
244              Wait X seconds for cmd prompt  after  issuing  command  (Default
245              Value: 3)
246
247       stonith_status_sleep
248              Sleep  X  seconds  between  status calls during a STONITH action
249              (Default Value: 1)
250
251       retry_on
252              Count of attempts to retry power on (Default Value: 3)
253
254       gnutlscli_path
255              Path to gnutls-cli binary (Default Value: /usr/bin/gnutls-cli)
256
257
258
259fence_ilo (Fence Agent)           2009-10-20                    FENCE_AGENT(8)
Impressum