Do not use this switch if launching from Systems Insight Manager.

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.

•-V is the optional switch that 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.

See the "Remote Insight Command Language (on page 138)" section for information on the syntax of the XML data files. Sample XML scripts are available on the HP website (http://www.hp.com/servers/lights- out) in the Best Practices section.

Using Perl with the XML scripting interface

The scripting interface provided enables administrators to manage virtually every aspect of the device in an automated fashion. Primarily, administrators use tools like the cpqlocfg.exe to assist deployment efforts. Administrators using a non-Windows® client can use Perl scripts to send XML scripts to the Lights- Out devices. Administrators can also use Perl to perform more complex tasks than cpqlocfg.exe can perform.

This section discusses how to use Perl scripting in conjunction with the Lights-Out XML scripting language. Perl scripts require a valid user ID and password with appropriate privileges. Sample XML scripts for Lights-Out devices and a sample Perl script are available on the HP website (http://www.hp.com/servers/lights-out)in the Best Practices section.

XML enhancements

Previous versions of RILOE II firmware do not return properly formatted XML syntax. If the RILOE II firmware determines the client utility being used does not support the return of properly formatted XML syntax, the following message appears:

<INFORM>Scripting utility should be updated to the latest version.</INFORM>

This message informs the customer to update to a later version of the cpqlocfg scripting utility. The latest version of cpqlocfg.exe is currently 2.21.

For customers using a utility other than cpqlocfg.exe, such as Perl scripts, the following steps can help ensure the RILOE II firmware returns properly formatted XML. Assuming the version of firmware is 1.20, <LOCFG version="2.21"> should be incorporated into the script sent to RILOE II. This tag can be placed in either the Perl script or the XML script. Placement of this tag is important. If placing this tag in the Perl script, the tag should be sent after <?xml version="1.0"?> and before the XML script is sent. If placing the tag in the XML script, the tag should be placed before <RIBCL version="2.0">. If you are using the Perl script provided by HP, then the bold line in the following example can be added to return properly formatted XML syntax.

•Perl script modification

…

# Open the SSL connection and the input file

my $client = new IO::Socket::SSL->new(PeerAddr => $host); open(F, "<$file") die "Can't open $file\n";

#Send the XML header and begin processing the file print $client '<?xml version="1.0"?>' . "\r\n";

#Send tag to RILOE II firmware to insure properly formatted XML is returned.

Scripting, command line, and utility options 129