HP Linux Server Management Software - Manual (Page 55)

Toolkit utilities 55
Using HPONCFG
The HPONFCG utility only supports HP ProLiant 300/500/700 and Blade servers.
HP offers support for the RILOE II, iLO, iLO 2, and iLO 3 features available on ProLiant servers with the
HPONCFG utility.
HPONCFG is an online configuration tool used to set up and reconfigure RILOE II, iLO, iLO 2, and iLO3
without requiring a reboot of the server operating system. The utility runs in a command-line mode and must
be executed from an operating system command-line.
HPONCFG enables you to initially configure features exposed through the RBSU or the RILOE II, iLO, iLO 2,
or iLO3. This utility is not intended for continued administration. CPQLOCFG should be used for ongoing
administration of user rights and network functionality on the server.
Observe the following requirements before using HPONCFG:
• The RILOE II, iLO, iLO 2, or iLO 3 Management Interface Driver must be loaded on the server.
HPONCFG displays a warning if the driver is not installed.
• HPONCFG requires minimum RILOE II, iLO,iLO 2, and iLO 3 firmware versions. To determine the
minimum firmware version required, see the HP SmartStart Scripting Toolkit Linux and Windows
Editions Support Matrix.
For more information, see the Remote Management website ( http://www.hp.com/servers/lights-out ).
HPONCFG command-line syntax
hponcfg [-help][-?][-reset][-f filename][-l filename]
[-w filename][-get_hostinfo][-m firmwarelevel]
IMPORTANT: Because the -w argument does not capture certain types of information, such as the
administrator password, data files created with HPONCFG using the -w argument cannot then be
used as input files for HPONCFG, unless they are modified first.
HPONCFG command-line arguments
Command-line argument Description
-help or -? These arguments display simple help messages.
-reset This argument resets the RILOE II, iLO, iLO 2, or iLO 3 to factory defaults.
-f filename
This argument sets the RILOE II, iLO, iLO 2, or iLO3 configuration based on
the information in the XML input file named filename.
-l filename
This argument logs replies to the text log file named filename.
-w filename This argument writes the RILOE II, iLO, iLO 2, or iLO 3 configuration
obtained from the device to the XML output file named filename.
-get_hostinfo This argument returns the host server name and serial number.
-m This argument indicates to HPONCFG the minimum firmware level that must
be present in the management device to execute the RIBCL script. If the
minimum level is not met, HPONCFG returns an error without performing
any additional actions.
-mouse This argument causes HPONCFG to configure the server for optimized
mouse handling.