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       --retry-on=[attempts]
123              Count of attempts to retry power on (Default Value: 3)
124
125       --gnutlscli-path=[path]
126              Path to gnutls-cli binary (Default Value: /usr/bin/gnutls-cli)
127
128

ACTIONS

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

STDIN PARAMETERS

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