HP iLO 3 Scripting and Command Line Guide

8 RIBCL XML Scripting Language
Overview of the RIBCL
RIBCL enables you to write XML scripts to configure and manage iLO 3 configuration settings, user
accounts, directory settings, server settings, and HP SSO settings. Download the sample scripts
from the HP website at http://www.hp.com/go/iLO3. Click HP iLO Sample Scripts for Windows
or HP Lights-Out XML Scripting Sample for Linux under Helpful Downloads.. 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, write comments in the command as needed. If a comment falls in
the command line, an error message is generated. Unless otherwise specified, examples in this
guide are specifically for iLO 3 firmware version 1.61 and later.
This section describes the XML commands and their parameters common to most LOM products
and servers. For more information about the ProLiant BL c-Class server and rack XML commands,
see the HP iLO User Guide on the HP website at: http://www.hp.com/go/ilo3 and click More
iLO Documentation.
XML headers
The following XML header must be present in every script, to ensure the connection is an XML
connection, not an HTTP connection:
<?xml version="1.0"?>
Data types
The three data types 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 must start with either a double or single quote, and it must end with the same type of quote.
The string can contain a quote if it is different from the string delimiter quotes.
For example, if a string starts with a double quote, a single quote can be used within the string
and the string must be closed with a double quote.
Unsupported Microsoft Windows quote characters:
Support for Windows-specific smart-quotes (“ ” and ‘ ’) as content delimiters in XML is being phased
out. Be sure to replace any smart-quote characters in your script with normal double or single
quotes (" and ').
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, no, true, false, y, n, t, f, 1, and 0. These strings are not case sensitive.
60 RIBCL XML Scripting Language