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

VERSION:  1.60
LANGUAGE:  English

CATEGORY:  Systems Management

DIVISIONS:  Systems

PRODUCTS AFFECTED:      ProLiant BL20p
			ProLiant BL20p G2
			ProLiant BL20p G3
			ProLiant BL30p	
			ProLiant BL40p
                        ProLiant ML370 G3
			ProLiant ML370 G4
                        ProLiant DL360 G2
			ProLiant DL360 G3
			ProLiant DL360 G4
			ProLiant DL380 G3
			ProLiant DL380 G4
			ProLiant DL560
		        ProLiant DL580 G2
			ProLiant DL585
			ProLiant DL740

OPERATING SYSTEM:  RedHat Enterprise Linux 2.1 & 3.0, RedHat 8.0, 7.3, 7.2, 
                   SuSe Linux Enterprise Server 7, United Linux 1.0

SYSTEM CONFIGURATION:  N/A

PREREQUISITE:  iLO 1.60 Firmware

EFFECTIVE DATE:  July 12, 2004

ELECTRONIC DISTRIBUTION ALLOWED:  Yes

SOFTPAQ UTILITY VERSION: 2.X

SUPERSEDES: v1.50



DESCRIPTION:  This is a set of sample XML script used to manage the
              configuration of Integrated Lights-Out (iLO) management
              processors and to control servers in which iLO devices
              are in use.

              Use CPQLOCFG.EXE ver 2.10 or greater with these scripts.
              These scripts were originally written for iLO firmware 
              version 1.10.  Other versions of firmware may use different
              syntax/privileges.

              See the iLO User Guide for more information on scripting
              and the syntax of the RIBCL XML.  

New features:
The following scripts have been added or modified to support
              additional firmware features available in 1.55 and 1.60:
              NEW SAMPLE SCRIPTS
                Eject_Virtual_Media.xml
                Get_VM_Status.xml
                Insert_Virtual_Media.xml
                Set_VM_Status.xml
                Get_Host_Data.xml
                Shared_Network_Port.xml
                RBSU_POST_IP.xml
                Get_IML.xml
                Get_iLO_Log.xml
                Administrator_reset_pw.xml
                Get_Enc_Bay_IP_Settings.xml
                Mod_Network_Settings.xml
                Mod_Enc_Bay_IP_Settings.xml

              NEW UTILITY
              The HPONCFG.EXE utility is now available, allowing you to use
              RIBCL scripts on line while running from the host.

              Requirements:
                - iLO 1.41 or later
                - RILOE II 1.13
                - the approprite lights-out driver

              HPONCFG passes the scripts to the local lights-out processor
              when running from an Administrator or root account on the host.

              You can use this utility to configure and operate lights-out
              without using the network connection.  The utility accepts
              existing RIBCL scripts.



Problems fixed from last release -



Documentation:

1.  Updated iLO User Guide 1.60 and Updated Information Booklet 1.60 can also be found by
    following the links at:  
	http://h20000.www2.hp.com/bizsupport/TechSupport/DocumentIndex.jsp?contentType=SupportManual&locale=en_US&docIndexId=179911&taskId=101&prodTypeId=15351&prodSeriesId=397989


HOW TO USE:
1. Unzip ilo-samples.zip to a subdirectory.  This zip files contains the following file:
   Add_User.xml - Add a user to the iLO user database.

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

   Change_Password.xml - Change the password of an existing iLO user.

   Clear_EventLog.xml - Clear the iLO Event Log

   Delete_User.xml - Delete a user from the iLO user database.

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

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

   Get_All_Users.xml - Return a list of all iLO user accounts.

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

   Get_Directory.xml - Return the current directory configuration of an iLO.

   Get_FW_Version.xml - Return the version and date/time of the iLO firmware.

   Get_Global.xml - Return global settings.

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

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

   Get_iLO_Log.xml - Retrieve the records in the iLO Event Log.

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

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

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

   Get_Network.xml - Return network settings.

   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 - Return the status of the specified Virtual Media device.

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

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

   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_Blade_Rack.xml - Change the BL p-Class blade and rack settings.

   Mod_DiagPort_Settings.xml - Change the iLO Diagnostic Port network settings.

   Mod_Directory.xml - Change the directory settings of an iLO.

   Mod_Global_Settings.xml - Change the iLO Global Settings.

   Mod_Network_Settings.xml - Change the iLO Network Settings.

   Mod_SNMP_IM_Settings.xml - Change the iLO SNMP and Insight Manager Settings.

   Mod_User.xml  - Change the login id, display name, password and/or
                   privileges for an existing iLO user account.
   
   Mod_Enc_Bay_IP_Settings.xml - Modify the static IP settings of individual blades
                                 in the respective enclosure.

   RBSU_POST_IP.xml - Configure iLO to display the IP address at POST.

   Reset_RIB.xml - Restart the iLO Management Processor.

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

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

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

   Shared_Network_Port.xml - Configure the iLO NIC port on supported platforms.

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

   Update_Firmware.xml - Flash the iLO firmware to a new version.

Utilities and documentation may be downloaded from:
   http://www.hp.com/servers/lights-out
   Click on iLO, then click on "Softwaer and Drivers" or
   "Support and Documents"documentation" for appropriate links.

   A valid iLO user account and password is required for each
   XML script when using CPQLOCFG.  The user account must have
   appropriate lights-out privileges to process the request.
   The CPQLOCFG utility connects to the iLO management processor
   using a 128-bit Secure Sockets Layer (SSL) connection.

CPQLOCFG -s [servername|ipaddress]|[:port] -l [logfilename] -f [input filename] -v -c
 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 Insight Manager 7.

        -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 Insight Manager 7.

        -f input filename is the filename containing the RIB Commands

        -v Enables verbose message logging. By default, only errors and
           responses from GET commands will be logged without the -v switch.

        -c Will cause CPQLOCFG to check for correct xml formatting,
           but not open a connection to the management processor.


Copyright 2004 Hewlett-Packard Development Company, L.P.

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