HP iLO 3 Scripting and Command Line Guide

Windows server installation
HPONCFG installs automatically when the Service Pack for ProLiant is installed. To install HPONCFG
manually, run the self-extracting executable.
HPONCFG creates a directory at:
%Program files%\HP\hponcfg.
Linux server installation
HPONCFG is installed automatically when Service Pack for ProLiant is installed. Download the
HPONCFG RPM package for Linux distributions from the HP website. Install the appropriate
package using the RPM installation utility.
For example, for a package installation, install the HPONCFG RPM package on Red Hat Enterprise
Linux 5 by entering the following command:
rpm -ivh hponcfg-3.5.0.linux.rpm
If you have an older version of the HPONCFG RPM package installed on the system, run the
following command to remove the older version before installing the new version of HPONCFG:
rpm –e hponcfg
The hp-ilo rpm package and the hp-health rpm package must be installed on the system
before installing the hponcfg rpm package.
After installation, the HPONCFG executable is located in the /sbin directory. Be sure that the
appropriate Management Interface Driver is installed. For details about where to obtain this driver
and file, see “HPONCFG requirements” (page 22).
HPONCFG utility
The HPONCFG configuration utility reads an XML input file, formatted according to the rules of
the RIBCL language, and produces a log file containing the requested output. A few sample scripts
are included in the HPONCFG delivery package.
A package containing various and comprehensive sample scripts is available for download on
the HP website at: http://www.hp.com/go/iLO3.
Click HP iLO Sample Scripts for Windows or HP Lights-Out XML Scripting Sample for Linux under
Helpful Downloads.
Typical usage is to select a script that is similar to the desired functionality and modify it for your
exact requirements. Although no authentication to iLO is required, the XML syntax requires that
the USER_LOGIN and PASSWORD tags are present in the LOGIN tag, and that these fields contain
data. To successfully execute HPONCFG, the utility must be invoked as Administrator on Windows
servers and as root on Linux servers. HPONCFG returns an error message if you do not possess
sufficient privileges.
HPONCFG command line parameters
HPONCFG accepts the following command line parameters:
Table 4 HPONCFG command line parameters
EffectParameter
Displays the help page/help or ?
Resets the iLO to factory default values/reset
Sets and receives the iLO configuration from the information given in the XML input file that
has name filename
/f filename
Sets and receives iLO configuration from XML input received through the standard input
stream
/i filename
HPONCFG utility 23