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 This parameter is always required.
39
40       -u, --ipport=[port]
41              TCP/UDP  port  to use for connection with device (Default Value:
42              443)
43
44       -l, --username=[name]
45              Login Name This parameter is always required.
46
47       -t, --notls
48              Disable TLS negotiation, force SSL 3.0 (Default Value: 1)
49
50       -p, --password=[password]
51              Login password or passphrase
52
53       -S, --password-script=[script]
54              Script to retrieve password
55
56       -r, --ribcl-version=[version]
57              Force ribcl version to use
58
59       -z, --ssl
60              SSL connection (Default Value: 1)
61
62       --ssl-insecure
63              SSL connection  without  verifying  fence  device's  certificate
64
65
66       --ssl-secure
67              SSL connection with verifying fence device's certificate
68
69       --tls1.0
70              Disable TLS negotiaton, force TLS 1.0
71
72       -v, --verbose
73              Verbose mode
74
75       -D, --debug-file=[debugfile]
76              Write debug information to given file
77
78       -V, --version
79              Display version information and exit
80
81       -h, --help
82              Display help and exit
83
84       --delay=[seconds]
85              Wait  X  seconds  before  fencing  is started (Default Value: 0)
86
87
88       --login-timeout=[seconds]
89              Wait X seconds for cmd prompt after login  (Default  Value:  10)
90
91
92       --power-timeout=[seconds]
93              Test  X  seconds  for status change after ON/OFF (Default Value:
94              20)
95
96       --power-wait=[seconds]
97              Wait X seconds after issuing ON/OFF (Default Value: 0)
98
99       --shell-timeout=[seconds]
100              Wait X seconds for cmd prompt  after  issuing  command  (Default
101              Value: 3)
102
103       --retry-on=[attempts]
104              Count of attempts to retry power on (Default Value: 3)
105
106       --gnutlscli-path=[path]
107              Path to gnutls-cli binary (Default Value: /usr/bin/gnutls-cli)
108
109

ACTIONS

111
112
113       on     Power on machine.
114
115       off    Power off machine.
116
117       reboot Reboot machine.
118
119       status This returns the status of the plug/virtual machine.
120
121       list   List  available  plugs with aliases/virtual machines if there is
122              support for more then one device. Returns N/A otherwise.
123
124       list-status
125              List available plugs with  aliases/virtual  machines  and  their
126              power  state  if it can be obtained without additional commands.
127
128
129       monitor
130              Check the health of fence device
131
132       metadata
133              Display the XML metadata describing this resource.
134
135

STDIN PARAMETERS

137
138
139       action Fencing Action (Default Value: reboot)
140
141       inet4_only
142              Forces agent to use IPv4 addresses only
143
144       inet6_only
145              Forces agent to use IPv6 addresses only
146
147       ipaddr IP Address or Hostname This parameter is always required.
148
149       ipport TCP/UDP port to use for connection with device  (Default  Value:
150              443)
151
152       login  Login Name This parameter is always required.
153
154       notls  Disable TLS negotiation, force SSL 3.0 (Default Value: 1)
155
156       passwd Login password or passphrase
157
158       passwd_script
159              Script to retrieve password
160
161       ribcl  Force ribcl version to use
162
163       ssl    SSL connection (Default Value: 1)
164
165       ssl_insecure
166              SSL  connection  without  verifying  fence  device's certificate
167
168
169       ssl_secure
170              SSL connection with verifying fence device's certificate
171
172       tls1.0 Disable TLS negotiaton, force TLS 1.0
173
174       verbose
175              Verbose mode
176
177       debug  Write debug information to given file
178
179       version
180              Display version information and exit
181
182       help   Display help and exit
183
184       delay  Wait X seconds before fencing  is  started  (Default  Value:  0)
185
186
187       login_timeout
188              Wait  X  seconds  for cmd prompt after login (Default Value: 10)
189
190
191       power_timeout
192              Test X seconds for status change after  ON/OFF  (Default  Value:
193              20)
194
195       power_wait
196              Wait X seconds after issuing ON/OFF (Default Value: 0)
197
198       shell_timeout
199              Wait  X  seconds  for  cmd prompt after issuing command (Default
200              Value: 3)
201
202       retry_on
203              Count of attempts to retry power on (Default Value: 3)
204
205       gnutlscli_path
206              Path to gnutls-cli binary (Default Value: /usr/bin/gnutls-cli)
207
208
209
210fence_ilo (Fence Agent)           2009-10-20                    FENCE_AGENT(8)