* RECOMMENDED * HP Lights-Out XML PERL Scripting Sample for Linux

To ensure the integrity of your download, HP recommends verifying your results with this MD5 Checksum value:

Installation:
Unzip/Untar linux-LOsamplescripts3.00.0-2.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_Micro_Ver.xml - Power Micro Firmware revision information of the server.
  
• 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.
  
• Import_SSH_Key.xml - Imports SSH key 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.
• hponcfgcap.xml -   Capture the current iLO configuration such as Global Settings, Network Settings, Users Information and  Directory Settings to a file using HPONCFG. 
• hponcfg_reformat.xsl - The stylesheet (.xsl) converts the iLO configuration captured using hponcfgcap.xml to a format  that can be used to restore the configuration of iLO.
  
• locfg.pl - Sample PERL script to send XML commands.
• vspconfig.pl - Set the Virtual Serial Port Configuration for Linux.
  
• ilo_perl_xml.pdf - Document PERL script usage.
• Clear_Power_On_Time.xml
• Get_Power_On_Time.xml
• Get_Pwreg_Alert_Threshold.xml
• Lock_Configuration.xml
• Mod_Network_Settings.xml
• Set_Pwreg_Alert_Threshold.xml
  
• linux-LOsamplescripts3.00.0-2.txt - this file.

http://www.hp.com/cgi-bin/hpsupport/index.pl

The locfg.pl script connects to the iLO 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] [-ilo2|-ilo3]


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 is the iLO user account name
  
• -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.
  
• -ilo2|-ilo3
             Specifies the type of device on the server. Communications with Integrated
             Lights-Out 3 (-ilo3) is different from other devices (-ilo2).
             Note: locfg.pl detects the device automatically if this option is not present.