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       -4, --inet4-only
32              Forces agent to use IPv4 addresses only
33
34       -6, --inet6-only
35              Forces agent to use IPv6 addresses only
36
37       -a, --ip=[ip]
38              IP address or hostname of fencing device
39
40       -u, --ipport=[port]
41              TCP/UDP  port  to use for connection with device (Default Value:
42              443)
43
44       -t, --notls
45              Disable TLS negotiation and force SSL3.0. This  should  only  be
46              used for devices that do not support TLS1.0 and up.
47
48
49       -p, --password=[password]
50              Login password or passphrase
51
52       -S, --password-script=[script]
53              Script to run to retrieve password
54
55       -n, --plug=[ip]
56              IP address or hostname of fencing device (together with  --port-
57              as-ip)
58
59       -r, --ribcl-version=[version]
60              Force ribcl version to use
61
62       -z, --ssl
63              Use SSL connection with verifying certificate (Default Value: 1)
64
65
66       --ssl-insecure
67              Use SSL connection without verifying certificate
68
69       --ssl-secure
70              Use SSL connection with verifying certificate
71
72       --tls1.0
73              Disable TLS negotiation and force TLS1.0. This  should  only  be
74              used for devices that do not support TLS1.1 and up.
75
76       -l, --username=[name]
77              Login name This parameter is always required.
78
79       -q, --quiet
80              Disable logging to stderr. Does not affect --verbose or --debug-
81              file or logging to syslog.
82
83       -v, --verbose
84              Verbose mode
85
86       -D, --debug-file=[debugfile]
87              Write debug information to given file
88
89       -V, --version
90              Display version information and exit
91
92       -h, --help
93              Display help and exit
94
95       --delay=[seconds]
96              Wait X seconds before fencing  is  started  (Default  Value:  0)
97
98
99       --login-timeout=[seconds]
100              Wait  X  seconds  for cmd prompt after login (Default Value: 10)
101
102
103       --port-as-ip
104              Make "port/plug" to be an alias to IP address
105
106       --power-timeout=[seconds]
107              Test X seconds for status change after  ON/OFF  (Default  Value:
108              20)
109
110       --power-wait=[seconds]
111              Wait X seconds after issuing ON/OFF (Default Value: 0)
112
113       --shell-timeout=[seconds]
114              Wait  X  seconds  for  cmd prompt after issuing command (Default
115              Value: 3)
116
117       --retry-on=[attempts]
118              Count of attempts to retry power on (Default Value: 3)
119
120       --gnutlscli-path=[path]
121              Path to gnutls-cli binary (Default Value: /usr/bin/gnutls-cli)
122
123

ACTIONS

125
126
127       on     Power on machine.
128
129       off    Power off machine.
130
131       reboot Reboot machine.
132
133       status This returns the status of the plug/virtual machine.
134
135       monitor
136              Check the health of fence device
137
138       metadata
139              Display the XML metadata describing this resource.
140
141       manpage
142               The operational behavior of this is not known.
143
144       validate-all
145              Validate if all required parameters are entered.
146
147

STDIN PARAMETERS

149
150
151       action Fencing action (Default Value: reboot)
152
153       inet4_only
154              Forces agent to use IPv4 addresses only
155
156       inet6_only
157              Forces agent to use IPv6 addresses only
158
159       ip     IP address or hostname of fencing device Obsoletes: ipaddr
160
161
162       ipport TCP/UDP  port  to use for connection with device (Default Value:
163              443)
164
165       notls  Disable TLS negotiation and force SSL3.0. This  should  only  be
166              used for devices that do not support TLS1.0 and up.
167
168
169       password
170              Login password or passphrase Obsoletes: passwd
171
172       password_script
173              Script to run  to  retrieve  password  Obsoletes:  passwd_script
174
175
176       plug   IP  address or hostname of fencing device (together with --port-
177              as-ip) Obsoletes: port
178
179       ribcl_version
180              Force ribcl version to use Obsoletes: ribcl
181
182       ssl    Use SSL connection with verifying certificate (Default Value: 1)
183
184
185       ssl_insecure
186              Use SSL connection without verifying certificate
187
188       ssl_secure
189              Use SSL connection with verifying certificate
190
191       tls1.0 Disable  TLS  negotiation  and force TLS1.0. This should only be
192              used for devices that do not support TLS1.1 and up.
193
194       username
195              Login name This parameter is always required.  Obsoletes:  login
196
197
198       quiet  Disable logging to stderr. Does not affect --verbose or --debug-
199              file or logging to syslog.
200
201       verbose
202              Verbose mode
203
204       debug_file
205              Write debug information to given file Obsoletes: debug
206
207       version
208              Display version information and exit
209
210       help   Display help and exit
211
212       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
213
214
215       login_timeout
216              Wait  X  seconds  for cmd prompt after login (Default Value: 10)
217
218
219       port_as_ip
220              Make "port/plug" to be an alias to IP address
221
222       power_timeout
223              Test X seconds for status change after  ON/OFF  (Default  Value:
224              20)
225
226       power_wait
227              Wait X seconds after issuing ON/OFF (Default Value: 0)
228
229       shell_timeout
230              Wait  X  seconds  for  cmd prompt after issuing command (Default
231              Value: 3)
232
233       retry_on
234              Count of attempts to retry power on (Default Value: 3)
235
236       gnutlscli_path
237              Path to gnutls-cli binary (Default Value: /usr/bin/gnutls-cli)
238
239
240
241fence_ilo (Fence Agent)           2009-10-20                    FENCE_AGENT(8)
Impressum