Lights-Out Configuration Utility parameters

• The -S switch is the switch that determines the iLO 3 that is to be updated. This switch is either the DNS name or IP address of the target server.

  Do not use this switch if you are launching from HP SIM. HP SIM will provide the address of the iLO 3 when CPQLOCFG.EXE is launched.

• The -F switch is the switch that gives the full path location and name of the RIBCL file that contains the actions to be performed on the board.
• The -U and -P switches specify the user login name and password. These options allow the login information within the script file to be overridden.

Be sure that the Lights-Out Configuration Utility is in a directory referenced by the PATH environment variable. Any log files generated are placed in the same directory as the Lights-Out Configuration Utility executable

The -L and -V switches might or might not be set depending on the IT administrator's preferences.

• The -L switch defines where the log file generated and what the file name will be. If this switch is omitted, a default log file with the DNS name or the IP address is created in the same directory used to launch CPQLOCFG.

  Do not use this switch if launching from HP SIM.

  NOTE: The output values might need to be modified to match the RIBCL syntax.

  NOTE: The -L parameter cannot designate an output log file. A default log file named with the DNS name or the IP address is created in the same directory where CPQLOCFG is launched.

• The optional -V switch turns on the verbose message return. The resulting log file contains all commands sent to the Remote Insight board, all responses from the Remote Insight board, and any errors. By default, only errors and responses from GET commands are logged without this switch.
• The -t namevaluepairs switch substitutes variables (%variable%) in the input file with values specified in namevaluepairs. Separate multiple namevaluepairs with a comma (,).

  For example:

  <RIBCL VERSION="2.0">

  <LOGIN USER_LOGIN="%user%" PASSWORD="%password%">

  <USER_INFO MODE="read">

  <GET_ALL_USERS/>

  </USER_INFO>

  </LOGIN>

  </RIBCL>

  Using a command line enter:

  Cpqlocfg -f filename -s serverip -t user=Admin,password=pass

  If the parameter contains multiple words, you must enclose the phrase within double quotes (""). Up to 25 variables are supported in an XML file. The maximum length of variable name is 48 characters.

  Web agent example:

  <RIBCL VERSION="2.0">

  <LOGIN USER_LOGIN="adminname" PASSWORD="password">

  <RIB_INFO MODE="write">

  <MOD_SNMP_IM_SETTINGS>

  <WEB_AGENT_IP_ADDRESS value=%WebAgent%/>

  </MOD_SNMP_IM_SETTINGS>

  </RIB_INFO>

  </LOGIN>

  </RIBCL>

  Invoke the script using:

  cpqlocfg -s <iLO-ip-name> -f mod_snmp_im_settings.xml -t WebAgent='"Your_Value_Here"'

  When replacing a token that requires double quotes, use single quotes around the token.

See "Using RIBCL" for information on the syntax of the XML data files. Sample XML scripts are available on the HP website in the Best Practices section.