User's Manual

Scripting, command line, and utility options 135
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