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

NAME

7       fence_ilo - Fence agent for HP iLO
8

DESCRIPTION

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

PARAMETERS

23
24
25       -o, --action=<action>
26              Fencing Action (Default Value: reboot)
27
28       -a, --ip=<ip>
29              IP Address or Hostname This parameter is always required.
30
31       -l, --username=<name>
32              Login Name This parameter is always required.
33
34       -p, --password=<password>
35              Login password or passphrase
36
37       -S, --password-script=<script>
38              Script to retrieve password
39
40       -z, --ssl
41              SSL connection (Default Value: true)
42
43       -r, --ribcl-version=<version>
44              Force ribcl version to use
45
46       -4, --inet4-only
47              Forces agent to use IPv4 addresses only
48
49       -6, --inet6-only
50              Forces agent to use IPv6 addresses only
51
52       -u, --ipport=<port>
53              TCP port to use for connection with device
54
55       -v, --verbose
56              Verbose mode
57
58       -D, --debug-file=<debugfile>
59              Write debug information to given file
60
61       -V, --version
62              Display version information and exit
63
64       -h, --help
65              Display help and exit
66
67       --power-timeout
68              Test  X  seconds  for status change after ON/OFF (Default Value:
69              20)
70
71       --shell-timeout
72              Wait X seconds for cmd prompt  after  issuing  command  (Default
73              Value: 3)
74
75       --login-timeout
76              Wait  X  seconds  for cmd prompt after login (Default Value: 10)
77
78
79       --power-wait
80              Wait X seconds after issuing ON/OFF (Default Value: 0)
81
82       --delay
83              Wait X seconds before fencing  is  started  (Default  Value:  0)
84
85
86       --retry-on
87              Count of attempts to retry power on (Default Value: 3)
88
89

ACTIONS

91
92
93       on     Power on machine.
94
95       off    Power off machine.
96
97       reboot Reboot machine.
98
99       status This returns the status of the plug/virtual machine.
100
101       list   List  available  plugs with aliases/virtual machines if there is
102              support for more then one device. Returns N/A otherwise.
103
104       monitor
105              Check if fencing device is running. List available plugs/virtual
106              machines or get status of machine (if it does not support more).
107
108
109       metadata
110               The operational behavior of this is not known.
111
112

STDIN PARAMETERS

114
115
116       action Fencing Action (Default Value: reboot)
117
118       ipaddr IP Address or Hostname This parameter is always required.
119
120       login  Login Name This parameter is always required.
121
122       passwd Login password or passphrase
123
124       passwd_script
125              Script to retrieve password
126
127       ssl    SSL connection (Default Value: true)
128
129       ribcl  Force ribcl version to use
130
131       inet4_only
132              Forces agent to use IPv4 addresses only
133
134       inet6_only
135              Forces agent to use IPv6 addresses only
136
137       ipport TCP port to use for connection with device
138
139       verbose
140              Verbose mode
141
142       debug  Write debug information to given file
143
144       version
145              Display version information and exit
146
147       help   Display help and exit
148
149       power_timeout
150              Test X seconds for status change after  ON/OFF  (Default  Value:
151              20)
152
153       shell_timeout
154              Wait  X  seconds  for  cmd prompt after issuing command (Default
155              Value: 3)
156
157       login_timeout
158              Wait X seconds for cmd prompt after login  (Default  Value:  10)
159
160
161       power_wait
162              Wait X seconds after issuing ON/OFF (Default Value: 0)
163
164       delay  Wait  X  seconds  before  fencing  is started (Default Value: 0)
165
166
167       retry_on
168              Count of attempts to retry power on (Default Value: 3)
169
170
171
172fence_ilo (Fence Agent)           2009-10-20                    FENCE_AGENT(8)