Typical usage is to select a script that is similar to the desired functionality and modify it for the exact desired functionality. Note that, although no authentication to the iLO management processor or the RILOE II is required, the XML syntax requires that the USER_LOGIN and PASSWORD tags be present in the LOGIN tag, and that these fields contain data. Any data will be accepted in these fields. To successfully execute HPONCFG, the utility must be invoked as Administrator on Windows® servers and as root on Linux servers. An error message will be returned by HPONCFG if the user does not possess sufficient privileges.

Using HPONCFG on Linux servers

Invoke the HPONCFG configuration utility from the command line. HPONCFG displays a usage page if it is entered with no command line parameters.

HPONCFG accepts as input an XML script formatted according to the rules of RIBCL (documented in the user guide in the section describing the use of CPQLOCFG).

The command line format is:

hponcfg

-?

 

hponcfg

-h

 

hponcfg

-m minFw

hponcfg

-r

[-m minFw ]

hponcfg

-w filename [-m minFw]

hponcfg

-g

[-m minFw]

hponcfg

-f filename [-l filename] [-v] [-m minFw]

See the "HPONCFG command line parameters (on page 135)" section for an explanation of the usage.

HPONCFG command line parameters

HPONCFG accepts the following command line parameters:

•/help or ?—Displays the help page.

•/reset—Resets the RILOE II or iLO management processor to factory default values.

•/f <filename>—Sets the RILOE II or iLO management processor configuration from the information given in the XML input file that has name "filename."

•/w <filename>—Writes the RILOE II or iLO management processor configuration obtained from the device to the XML output file that has name filename.

•/l <filename>—Log replies to the text log file that has name filename.

•/get_hostinfo—Gets the host information. Returns the server name and server serial number.

•/m—Indicates to HPONCFG the minimum firmware level that should 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—Tells HPONCFG to configure the server for optimized mouse handling, there by optimizing graphical remote console performance. By default it optimizes for remote console single cursor mode for the current user. The dualcursor command line option along with the mouse option will optimize mouse handling as suited for remote console dual cursor mode. The 'allusers' command line option will optimize the mouse handling for all the users on the system. This option is available only for Windows®.

The options must be preceded by a / (slash) for Windows® and - or - for Linux as specified in the usage string.

Example HPONCFG command line:

HPONCFG /f add_user.xml /l log.txt > output.txt

Scripting, command line, and utility options 135