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       --plug-separator=[char]
97              Separator for plug parameter when specifying more  than  1  plug
98              (Default Value: ,)
99
100       --delay=[seconds]
101              Wait  X  seconds  before  fencing  is started (Default Value: 0)
102
103
104       --disable-timeout=[true/false]
105              Disable timeout (true/false) (default: true when run from  Pace‐
106              maker 2.0+)
107
108       --login-timeout=[seconds]
109              Wait  X  seconds  for cmd prompt after login (Default Value: 10)
110
111
112       --port-as-ip
113              Make "port/plug" to be an alias to IP address
114
115       --power-timeout=[seconds]
116              Test X seconds for status change after  ON/OFF  (Default  Value:
117              20)
118
119       --power-wait=[seconds]
120              Wait X seconds after issuing ON/OFF (Default Value: 0)
121
122       --shell-timeout=[seconds]
123              Wait  X  seconds  for  cmd prompt after issuing command (Default
124              Value: 3)
125
126       --stonith-status-sleep=[seconds]
127              Sleep X seconds between status calls  during  a  STONITH  action
128              (Default Value: 1)
129
130       --retry-on=[attempts]
131              Count of attempts to retry power on (Default Value: 3)
132
133       --gnutlscli-path=[path]
134              Path to gnutls-cli binary (Default Value: /usr/bin/gnutls-cli)
135
136

ACTIONS

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

STDIN PARAMETERS

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