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

5 Group administration and iLO 2 scripting

Lights-Out Configuration Utility

The Lights-Out Configuration Utility (CPQLOCFG.EXE) is a Microsoft Windows-based utility that

connects to the iLO 2 using a secure connection over the network. RIBCL scripts are passed to the

iLO 2 over the secure connection to CPQLOCFG. This utility requires a valid user ID and password

with the appropriate privileges. The CPQLOCFG utility can be launched from HP SIM for Group

Administration or used independently from a command prompt for batch processing. This utility

can be downloaded from the HP website at http://www.hp.com/servers/lights-out.

Version 2.28 or later of CPQLOCFG.EXE is required to support all features of iLO 1.93 and later

and iLO 2 1.00 and later.

HP SIM discovers iLO 2 devices as management processors. The Lights-Out Configuration Utility

sends a RIBCL file to a group of iLO 2s to manage the user accounts for those iLO 2 devices. The

iLO 2 devices then perform the action designated by the RIBCL file and send a response to the log

file.

The Lights-Out Configuration Utility is used to execute RIBCL scripts on the iLO 2 and must reside

on the same server as HP SIM. The Lights-Out Configuration Utility generates two types of error

messages: runtime and syntax.

• Runtime errors occur when an invalid action is requested. Runtime errors are logged to the

C:\PROGRAM FILES\INSIGHT MANAGER\HP\SYSTEMS directory.

• Syntax errors occur when an invalid XML tag is encountered. When a syntax error occurs,

the Lights-Out Configuration Utility stops running and logs the error in the runtime script and

output log file.

Syntax errors take the format of

Syntax error: expected X but found Y.

For example:

Syntax error: expected USER_LOGIN=userlogin but found

USER_NAME=username.

For a complete listing of errors, see “Using RIBCL” (page 70).

Unauthenticated XML query

If configured to do so, the iLO 2 device will return some identifying information in response to an

unauthenticated XML query. By default, the iLO 2 is configured to return this information. To disable

this feature, set the CIM_SECURITY_MASK in the MOD_SNMP_IM_SETTINGS command to disallow

returned information.

To obtain unauthenticated identifying information, submit the following command to the iLO 2 web

server port:

https://<iloaddress>/xmldata?item=all

A typical response to this command is:

<?xml version="1.0" ?>

<RIMP>

<HSI>

<SPN>ProLiant DL380 G5</SPN>

</HSI>

Lights-Out Configuration Utility 47