HP Integrated Lights-Out 2 Management Processor Scripting and Command Line Resource Guide

Linux server installation
HPONCFG is installed automatically when ProLiant Support Pack is installed. The rpm of HPONCFG
for Linux distributions can be downloaded from the HP website. Install the appropriate package
using the rpm installation utility. For example, for a package installation, you can install hponcfg
rpm on Red Hat Enterprise Linux 3 by entering the following command:
rpm -ivh hponcfg-1.9.0-3.linux.rpm
If an older version of the hponcfg RPM package is installed on the system, run the following
command to remove the older version before installing the new version of HPONCFG:
rpm –e hponcfg
The iLO or RILOE II driver (hp-ilo or hprsm) 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. See the section, "HPONCFG requirements"
for details about where to obtain this driver and file.
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.
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, iLO 2, or RILOE II 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. Any data is accepted in these fields. 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:
• /help or ? – Displays the help page.
• /reset – Resets the RILOE II, iLO, or iLO 2 to factory default values.
• /f <filename> – Sets and receives the RILOE II, iLO, or iLO 2 configuration from the
information given in the XML input file that has name filename.
• /i <filename> – Sets and receives RILOE II, iLO or iLO2 configuration from XML input received
through the standard input stream.
• /w <filename> – Writes the RILOE II, iLO, or iLO 2 configuration obtained from the device
to the XML output file that has the name filename.
• /l <filename> – Logs replies to the text log file that has name filename.
• /s <namevaluepairs> or /substitute <namevaluepairs> – Substitutes variables present
in the input config file with values specified in <namevaluepairs>.
• /get_hostinfo – Receives the host information. Returns the server name and server serial
number.
• /m – Indicates the minimum firmware level that must be present in the management device to
execute the RIBCL script. If at least this level of firmware is not present, HPONCFG returns an
error without performing any additional action.
• /mouse – Configures the server for optimized mouse handling to improve graphical remote
console performance. By default, it optimizes for remote console single cursor mode for the
current user. The
HPONCFG utility 63