SOFTPAQ NUMBER: N/A PART NUMBER: N/A FILE NAME: N/A TITLE: HP Lights-Out XML Scripting Sample VERSION: 1.80.0-1 LANGUAGE: English CATEGORY: Systems Management DIVISIONS: Systems PRODUCTS AFFECTED: ProLiant BL20p ProLiant BL20p G2 ProLiant BL20p G3 ProLiant BL25p ProLiant BL30p ProLiant BL35p ProLiant BL40p ProLiant BL45p ProLiant ML350 G4p ProLiant ML370 G3 ProLiant ML370 G4 ProLiant ML570 G3 ProLiant DL320 G3 ProLiant DL360 G2 ProLiant DL360 G3 ProLiant DL360 G4, G4p ProLiant DL380 G3 ProLiant DL380 G4 ProLiant DL385 ProLiant DL560 ProLiant DL580 G2, G3 ProLiant DL585 ProLiant DL740 OPERATING SYSTEM: Windows SYSTEM CONFIGURATION: N/A PREREQUISITE: iLO 1.80 Firmware EFFECTIVE DATE: 7/8/2005 ELECTRONIC DISTRIBUTION ALLOWED: Yes SOFTPAQ UTILITY VERSION: 2.X SUPERSEDES: v1.70 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.24 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.80: NEW SAMPLE SCRIPTS Mod_VLAN.xml Mod_Schemaless_Directory.xml Get_Host_Pwr_Reg_Info.xml Mod_2Factor.xml Import_2Factor_Certs.xml Get_2Factor.xml Problems fixed from last release - Documentation: 1. HP Integrated Lights-Out 1.70 USer Guide and HP Integrated Lights-Out 1.70 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 ilosamplescripts1.80.0-1.zip to a subdirectory. This zip file contains the following scripts: Add_User.xml - Add a user to the iLO user database. Administrator_reset_pw.xml- Reset the default administrator account password using HPONCFG. Cert_Request.xml - Request a Certificate Signing Request from iLO 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_Host_Power_Saver.xml - Return the current Power Regulator setting. 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. Get_Host_Pwr_Reg_Info.xml - Obtain the power regulator state information for supported platforms. Get_2Factor.xml - Obtain the the two factor authentication configuration settings. Hotkey_Config.xml - Change the values for Remote Console hotkeys. Import_Cert.xml - Import a signed certificate into iLO. Import_2Factor_Cert.xml - Import certificates into iLO. 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_Schemaless_Directory.xml - Change the schemaless 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. Mod_2Factor.xml Mod_VLAN.xml - Configure iLO virtual LAN settings. Mod_2Factor.xml - Configure iLO two-factor authentication settings. 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_Host_Power_Saver.xml - Change the Power Regulator setting. 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. locfg.pl - Sample PERL script to send XML commands. ilo_perl_xml.pdf - Document PERL script usage. Utilities and documentation may be downloaded from: http://h18013.www1.hp.com/support/files/lights-out/us/index.html 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 -u -p 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. -u username -p password Command line user name and password override those which are in the script file. Copyright 2005 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.