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

9 Using RIBCL
Overview of the RIBCL
RIBCL enables you to write XML scripts to configure and manage iLO 2 configuration settings, user
accounts, directory settings, server settings, and HP SIM SSO settings. You can download sample
scripts for all iLO 2 commands described in this section from the HP website at http://www.hp.com/
servers/lights-out. Before using the XML sample scripts downloaded from the HP website, read the
firmware support information in each sample script to tailor the script for the intended firmware
and version.
When writing your XML scripts, do write comments in the command. If a comment falls in the
command line, an error message is generated. Unless otherwise specified, examples in this guide
are specifically for iLO 2 firmware version 1.10 and later.
The "Using RIBCL" section describes the XML commands and their parameters common to most
LOM products and servers. For more information about the ProLiant BL p-class server and rack XML
commands, see the HP Integrated Lights-Out 2 User Guide.
XML header
The XML header ensures the connection is an XML connection, not an HTTP connection. The XML
header is built into the cpqlocfg utility and has the following format:
<?xml version="1.0"?>
Data types
The three data types that are allowed in the parameter are:
• String
• Specific string
• Boolean string
String
A string is any text enclosed in quotes. It can include spaces, numbers, or any printable character.
A string may start with either a double or single quote and it must end with the same type of quote.
The string may contain a quote if it is different from the string delimiter quotes.
For example, if a string is started with a double quote, a single quote can be used within the string
and the string must be closed with a double quote.
Specific string
A specific string is one that is required to contain certain characters. In general, you have a choice
of words that are accepted as correct syntax and all other words produce an error.
Boolean string
A Boolean string is a specific string that specifies a yes or no condition. Acceptable Boolean
strings are yes, y, no, n, true, t, false, and f. These strings are not case sensitive.
Response definitions
Every command that is sent to the iLO 2 generates a response. The response indicates whether the
command succeeded or failed. Some commands generate additional information. The additional
information is displayed in execution sequence, provided no errors occurred.
Example:
<RESPONSE
70 Using RIBCL