RIBCL Sample Script for Integrated Lights-Out
Copyright (c) 2003 Hewlett-Packard Development Company, L.P.
 

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 script 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.

Updates:      The following scripts have been added or modified to support
              additional firmware features available in 1.50:
              Add_User.xml - commented out unused privileges (see file for details)
              Get_Global.xml - new script
              Get_Network.xml - new script
              Get_Diagport.xml - new script
              Get_All_User_Info.xml - new script
              Get_Directory.xml - new script
              Get_SNMP_IM.xml - new script
              Mod_Global_Settings.xml - added new features (see file for details)
              Mod_User.xml - commented out unused privileges (see file for details)
              Set_Host_Power.xml - script replaces both Set_Host_Power_OFF.xml
                                   and Set_Host_Power_ON.xml (see file for details)
              UID_Control.xml - script replaces both UID_Control_OFF.xml
                                   and UID_Control_ON.xml (see file for details)

Downloads:    The CPQLOCFG.EXE utility and the iLO User Guide may be 
              downloaded from the http://www.hp.com/servers/lights-out URL.
              Click on the iLO chip to reach the iLO home page.  Click
              on 'documentation' to find the User Guide.  Click on 
              'drivers & firmware' to find the CPQLOCFG.EXE utility and the 
              latest iLO firmware.

Security:     A valid iLO user account and password is required for each
              XML script.  The user account must have the appropriate 
              privileges (Configure iLO Settings and/or Manage iLO Accounts).
              The CPQLOCFG utility connects to the iLO management processor
              using a 128-bit Secure Sockets Layer (SSL) connection.

Syntax:       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.

Contents:

   Add_User.xml - Add a user to the iLO user database.

   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.

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

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

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

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

   Get_Global.xml - Return global settings.

   Get_Network.xml - Return network settings.

   Get_Diagport.xml - Return BL p-class diagport 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_All_User_Info.xml - Return the configuration details for all users.

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

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

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

   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_Global_Settings.xml - Change the iLO Global Settings.

   Mod_Network_Settings.xml - Change the iLO Network Settings.

   Mod_DiagPort_Settings.xml - Change the iLO Diagnostic Port 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_Directory.xml - Change the directory settings of an iLO.

   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.

   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.

