SOFTPAQ NUMBER: N/A
PART NUMBER: N/A
FILE NAME: N/A
TITLE: HP Lights-Out XML PERL Scripting Sample for Linux

VERSION: 2.20.0-1
LANGUAGE: English

CATEGORY: Systems Management

DIVISIONS: Systems

PRODUCTS AFFECTED: ProLiant BL685c
ProLiant BL480c
ProLiant BL465c
ProLiant BL460c
ProLiant BL45p G2
ProLiant BL45p
ProLiant BL40p
ProLiant BL35p
ProLiant BL30p
ProLiant BL25p G2
ProLiant BL25p
ProLiant BL20p G4
ProLiant BL20p G3
ProLiant BL20p G2
ProLiant BL20p
ProLiant DL740
ProLiant DL585 G2
ProLiant DL585
ProLiant DL580 G4
ProLiant DL580 G3
ProLiant DL580 G2
ProLiant DL580
ProLiant DL560
ProLiant DL385 G2
ProLiant DL385
ProLiant DL380 G5
ProLiant DL380 G4
ProLiant DL380 G3
ProLiant DL365
ProLiant DL360 G5
ProLiant DL360 G4
ProLiant DL360 G4p
ProLiant DL360 G3
ProLiant DL360 G2
ProLiant DL320 G5
ProLiant DL320 G4
ProLiant DL320 G3
ProLiant ML570 G4
ProLiant ML570 G3
ProLiant ML370 G5
ProLiant ML370 G4
ProLiant ML370 G3
ProLiant ML350 G5
ProLiant ML350 G4
ProLiant ML350 G4p
ProLiant ML310 G4
ProLiant ML310 G3
StorageWorks 600 All-in-One Storage System
ProLiant DL380 G5 Data Protection Storage Server
ProLiant DL380 G5 Storage Server
ProLiant ML350 G5 Storage Server
Remote Insight Lights-Out Edition II Board

OPERATING SYSTEM: Linux

SYSTEM CONFIGURATION: N/A

PREREQUISITE: N/A

EFFECTIVE DATE: 6/22/2007

ELECTRONIC DISTRIBUTION ALLOWED: Yes

SOFTPAQ UTILITY VERSION: N/A

SUPERSEDES: 2.10.0-1

DESCRIPTION: This is a set of sample XML script used to manage the configuration
of Lights-Out management processors and to control servers in which
following devices are in use:
Integrated Lights-Out 2
Integrated Lights-Out
Remote Insight Lights-Out Edition II

Use CPQLOCFG.EXE ver 2.26 or greater with these scripts.

See "HP Integrated Lights-Out Management Processor Scripting and
Command Line Resource Guide" for more information on scripting and
the syntax of the RIBCL XML.

Documentation:

1. HP Lights-Out User Guides and HP Integrated Lights-Out Management Processor
Scripting and Command Line Resource Guide can also be found by following the
link at:

http://h18013.www1.hp.com/products/servers/management/ilo/documentation.html

Select manuals under self help resources for a list of product documentation.

HOW TO USE:

1. Unzip/Untar linux-LOsamplescripts2.20.0-1.tgz to a subdirectory. This file
contains the following scripts:

Add_SSO_Rec.xml - Add an HP SIM Single Sign-On (SSO) record to the end of the database.

Add_User.xml - Add a user to the Lights-Out device user database.

Administrator_reset_pw.xml- Reset the default administrator account password using HPONCFG.

Cert_Request.xml - Request a Certificate Signing Request from Lights-Out device.

Change_Password.xml - Change the password of an existing Light-Out device user.

Clear_EventLog.xml - Clear the Light-Out device Event Log.

Clear_IML.xml - Clear the server Integrated Management Log (IML).

Computer_Lock_Config.xml - Change the values for Computer Lock settings.

Copy_Virtual_Floppy.xml - Copy the contents of the Virtual Floppy from the on-board memory
of a Remote Insight Lights-Out Edition II board to a file.

Delete_SSO_Rec.xml - Delete an HP SIM Single Sign-On (SSO) record by index.

Delete_User.xml - Delete a user from the Light-Out device user database.

Eject_Virtual_Media.xml - Ejects the image of the specified Virtual Media device.

Get_2Factor.xml - Obtain the two factor authentication configuration settings.

Get_All_Cables_Status.xml - Return the status of all cables that may be connected to a
Remote Insight Lights-Out Edition II board.

Get_All_User_Info.xml - Return the configuration details for all users.

Get_All_Users.xml - Return a list of all user accounts on Lights-Out device.

Get_Diagport.xml - Return BL p-class diagport settings.

Get_Directory.xml - Return the current directory configuration of an Lights-Out device.

Get_EmHealth.xml - Return the health information of the server.

Get_Enc_Bay_IP_Settings.xml - Obtain static IP settings of individual blades
in the respective enclosure.

Get_FW_Version.xml - Return the version and date/time of the Lights-Out device firmware.

Get_Global.xml - Return global settings.

Get_Host_APO.xml - Retrieve server automatic power on and power on delay settings.

Get_Host_Data.xml - Retrieve SMBIOS data from Server Information page.

Get_Host_Pwr_Reg_Info.xml - Obtain the power regulator state information for
supported platforms.

Get_Host_Power_Saver.xml - Return the current Power Regulator setting.

Get_Host_Power.xml - Return the current power state of the host server.

Get_iLO_Log.xml - Retrieve the records in the Lights-Out device Event Log.

Get_IML.xml - Retrieve the records in the Integrated Management Log.

Get_Network.xml - Return network settings.

Get_Power_Readings.xml: Return the power readings from the server.

Get_Server_Name.xml: Return the host server name.

Get_SNMP_IM.xml - Return the current SNMP and Insight Manager security settings.

Get_SSO_Settings.xml - Retrieve the HP SIM Single Sign-On (SSO) settings.

Get_PowerCap.xml - Return Power Cap setting.

Get_Topology.xml - Return BL p-Class rack infrastructure topology.

Get_UID_Status.xml - Return the current state of the server's Unit ID (UID) on
the host server.

Get_User.xml - Return the configuration details for a single user.

Get_VM_Status.xml - Return the status of the specified Virtual Media device.

Get_VPB_Cable_Status.xml - Return the status of the Virtual Power Button cable that may
be connected to a Remote Insight Lights-Out Edition II board.

Hotkey_Config.xml - Change the values for Remote Console hotkeys.

Import_2Factor_Cert.xml - Import certificates into iLO.

Import_Cert.xml - Import a signed certificate into a Lights-Out device.

Insert_Virtual_Media.xml - Inserts the Virtual Media image via specified URL.

License.xml - Add the iLO Advanced Pack license key for a server.

Mod_2Factor.xml - Configure two-factor authentication settings.

Mod_Blade_Rack.xml - Change the BL p-Class blade and rack settings.

Mod_DiagPort_Settings.xml - Change the Lights-Out device Diagnostic Port
network settings.

Mod_Directory.xml - Change the directory settings of an Lights-Out device.

Mod_Enc_Bay_IP_Settings.xml - Modify the static IP settings of individual blades
in the respective enclosure.

Mod_Global_Settings.xml - Change the Lights-Out device Global Settings.

Mod_Network_Settings.xml - Change the Lights-Out device Network Settings.

Mod_Schemaless_Directory.xml - Change the schemaless directory settings of an iLO.

Mod_SNMP_IM_Settings.xml - Change the Lights-Out device SNMP and Insight
Manager Settings.

Mod_SSO_Settings.xml - Configure the HP SIM Single Sign-On (SSO) settings.

Mod_User.xml - Change the login id, display name, password and/or
privileges for an existing user account on a Lights-Out device.

Mod_VLAN.xml - Configure virtual LAN settings on a Light-Out device.

RBSU_POST_IP.xml - Configure Lights-Out device to display the IP address at POST.

Reset_RIB.xml - Restart the Lights-Out Management Processor.

Reset_Server.xml - Immediately power off and back on the host server.

Set_Host_APO.xml - Change server automatic power on and power on delay settings.

Set_Host_Power_Saver.xml - Change the Power Regulator setting.

Set_Host_Power.xml - Power on/off the host server.

Set_PowerCap.xml - Change the Power Cap setting.

Set_Server_Name.xml: Set the host server name.

Set_VM_Status.xml - Set the boot options, write protection of the specified
Virtual Media device.

Shared_Network_Port.xml - Configure Lights-Out device to pass network traffic on
the shared host network port on supported platforms.

UID_Control.xml - Turn on/off the Unit ID (UID) light on the host server.

Update_Firmware.xml - Flash the Lights-Out device firmware to a new version.

locfg.pl - Sample PERL script to send XML commands.

ilo_perl_xml.pdf - Document PERL script usage.

linux-LOsamplescripts2.20.0-1.txt - this file.

Utilities and documentation may be downloaded from:

http://h18013.www1.hp.com/support/files/lights-out/us/index.html

A valid iLO 2 user account and password is required for each
XML script when using CPQLOCFG. The user account must have
appropriate lights-out 2 privileges to process the request.

The locfg.pl script connects to the iLO 2 management processor
using a Secure Sockets Layer (SSL) connection.

perl locfg.pl -s {servername|ipaddress}[:port] -l [logfilename] -f input_filename [-u username -p password]

Where:
-s servername is the DNS name of target server.
-s ipaddress is the IP Address of the target server.
If a port is not specified, the port will default to :443.
DO NOT USE this switch if launching from System Insight Manager.

-l logfilename is the name of the file to log all output to.
A default file with the server name/ipaddress is created
if this option is not specified.
DO NOT USE this switch if launching from System Insight Manager.

-f input_filename is the filename containing the RIB Commands
-u username
-p password Command line user name and password override those
which are in the script file.
Note: Use -u and -p with caution as command line options are visible on Linux.

Hewlett-Packard and the Hewlett-Packard logo are trademarks of Hewlett-Packard
Development Company, L.P/ in the U.S. and/or other countries.