Printable version

Drivers & software

HPE Lights-Out XML Scripting Sample for Windows

By downloading, you agree to the terms and conditions of the Hewlett Packard Enterprise Software License Agreement.
Note:  Some software requires a valid warranty, current Hewlett Packard Enterprise support contract, or a license fee.

Type: Software - Lights-Out Management
Version: 5.10.0(16 Jan 2018)
Operating System(s): Microsoft Windows 10 (32-bit)
Microsoft Windows 10 (64-bit)
Microsoft Windows 7 (32-bit)
Microsoft Windows 7 (64-bit)
Microsoft Windows 8 (32-bit)
Microsoft Windows 8 (64-bit)
Microsoft Windows 8.1 (32-bit)
Microsoft Windows 8.1 (64-bit)
Microsoft Windows Server 2008 R2
Microsoft Windows Server 2008 W32
Microsoft Windows Server 2008 x64
Microsoft Windows Server 2012
Microsoft Windows Server 2012 Essentials
Microsoft Windows Server 2012 R2
Microsoft Windows Server 2016
Microsoft Windows Server 2019
File name: windows-LOsamplescripts5.10.0.zip (147 KB)
The HPE Lights-Out management processors support an advanced scripting interface for group configuration and server actions. The scripting capability of the iLO provides an easy and efficient way to configure and maintain management processors in large scale IT environments, saving time and costs. The Lights-Out Configuration Utility can be used to configure iLO 5, iLO 4 and iLO 3.

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


Added Get_PS_Data.xml to sample script bundle.

Prerequisites:

Use HP Lights-Out Configuration Utility (HPQLOCFG.EXE) ver 1.0.0 or greater with these scripts.
Note: HP Lights-Out Configuration Utility may be downloaded from www.hpe.com/info/iLO, TOOLS under Resources section.

A valid iLO user account and password is required for each XML script when using HPQLOCFG. The user account must have appropriate Lights-Out privileges to process the request.


To ensure the integrity of your download, HPE recommends verifying your results with this SHA-256 Checksum value:

063fefff959ebbd61b64804fc80cd891ee0bd703c709e3306fb30b3e9d816dec windows-LOsamplescripts5.10.0.zip

Reboot Requirement:
Reboot is not required after installation for updates to take effect and hardware stability to be maintained.


Installation:

1. Download and install the HP Lights-Out Configuration Utility (HPQLOCFG.EXE) on your client system.
2. Then, download and unzip the HPE Lights-Out Scripting Sample file and modify these sample scripts.
3. Run the HPQLOCFG program in a batch process or using Systems Insight Manager.

This zip file contains the following scripts:

  • Abort_Directory_test.xml - This is a sample XML script to abort ongoing directory test.
  • Add_Federation_Group.xml - This is a sample XML script to add a Federation group membership and grant associated privileges
  • Add_SSO_Rec.xml - Add an HPE 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_AHS_Data.xml - Clear the AHS data. 
  • Clear_EventLog.xml - Clear the Light-Out device Event Log.
  • Clear_IML.xml - Clear the server Integrated Management Log (IML).
  • Clear_Power_On_Time.xml - Clear the power-on time counter.
  • Computer_Lock_Config.xml - Change the values for Computer Lock settings.
  • Delete_Federation_Group.xml - This is a sample XML script to delete a Federation group membership
  • Delete_SSH_Key.xml - This is a sample XML script that deletes existing SSH key.
  • Delete_SSO_Rec.xml - Delete an HPE 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.
  • ERS_AHS_Submit.xml - This is a sample XML script to initiate AHS data submission to IRS.
  • ERS_DC_CompleteRegistration.xml - This is a sample XML script to complete the server registration.
  • ERS_DC_RegisterDevice.xml - This is a sample XML script to connect ERS to Insight Online and perform the 1st step of server registration.
  • ERS_DC_SetWebProxy.xml - This is a sample XML script to modify the Web Proxy information required by  ERS to communicate with Insight Online.
  • ERS_Disable.xml - This is a sample XML script to disable iLO ERS functionality and un-register the server.
  • ERS_Get_Settings.xml - This is a sample XML script to retrieve current ERS settings.
  • ERS_IRS_Enable.xml - This is a sample XML script to connect ERS to Insight Remote Support server (IRS) and register the server.
  • ERS_L2_Collection_Submit.xml - This is a sample XML script to initiate a L2 data collection submission to IRS.
  • ERS_Test_Event_Submit.xml - This is a sample XML script to initiate a test service event submission to IRS.
  • Factory_Defaults.xml - Sets the Lights-out device to factory default settings.
  • Get_AHS_Status.xml - This is a sample XML script to find out if AHS is enabled or disabled.
  • Get_All_Languages.xml - This is a sample XML script to read all languages that are supported on iLO.
  • Get_All_Licenses.xml - This is a sample XML script to get the license information.
  • 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_Asset_Tag.xml - This is a sample XML script to get the asset tag.
  • Get_Boot_Mode.xml - This is a sample XML script to get the pending boot mode.
  • Get_Current_Boot_Mode.xml - This is a sample XML script to get the current boot mode.             
  • Get_Directory.xml - Return the current directory configuration of an Lights-Out device.
  • Get_Directory_Test_Results.xml - This is a sample XML script to get directory test results.
  • Get_discovery_services.xml - This is a sample XML script to read location discovery Services data.
  • Get_EmHealth.xml - Return the health information of the server.
  • Get_Embedded_health.xml - Retrieves health information of the server.
  • Get_Encrypt.xml - This is a sample XML script to return current encryption settings
  • Get_Federation_Group.xml - This is a sample XML script to retrieve the privileges granted to a specified Federation
  • Get_Federation_All_Groups.xml - This is a sample XML script to retrieve a list of all Federation group memberships
  • Get_Federation_All_Groups_Info.xml - This is a sample XML script to retrieve a list of all Federation group memberships and granted privileges
  • Get_Federation_Multicast_Options.xml - This is a sample XML script to retrieve the current Federation multicast options.
  • Get_FIPS_Status.xml - Return the status of FIPs mode.
  • 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_CTRO.xml - To get the critical temperature shutdown behavior of a server.
  • 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_Host_Pwr_Micro_Ver.xml - Power Micro Firmware revision information of the server.
  • Get_Hotkey_Config.xml - Retrieve the Remote Console hotkeys.
  • 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_language.xml - This is a sample XML script to get the default language setting and to retrieve the list of installed languages.
  • Get_LDAP_CA_Cert_Status.xml - Return LDAP CA certificate status.
  • Get_Network.xml - Return network settings.
  • Get_OA_Info.xml - Return enclosure data for c-Class Blade Infrastructure.
  • Get_One_Time_Boot_Order.xml - This is a sample XML script to retrieve the current State of the One Time Boot.
  • Get_Persistent_Boot_Order.xml - This is a sample XML script to retrieve the current State of the Boot Order.
  • Get_Persmouse_Status.xml  - Get the persistent mouse and keyboard status.         
  • Get_Power_On_Time.xml - Return the number of minutes the server has been powered on and running.
  • Get_Power_Readings.xml: Return the power readings from the server.
  • Get_PowerCap.xml - Return Power Cap setting.
  • Get_Product_name.xml -  Get the product name.
  • Get_PS_Data.xml -  Return the power supply information of the server.
  • Get_Pwreg_Alert_Threshold.xml - Return the current power alert threshold settings.
  • Get_Rack_Settings.xml - This is a sample XML script to return enclosure data for c-Class blade infrastructure
  • Get_Security_Msg.xml - This is a sample XML script to retrieve the current security text message set in the iLO Login Banner.
  • Get_Server_Name.xml - Return the host server name.
  • Get_Server_FQDN.xml - This is a sample XML script to get the host server FQDN.
  • Get_SNMP_IM.xml - Return the current SNMP and Insight Manager security settings.
  • Get_SSO_Settings.xml - Retrieve the HPE SIM Single Sign-On (SSO) settings.
  • Get_Supported_Boot_Mode.xml - This is a sample XML script to get the supported boot mode(s).
  • Get_TPM_Status.xml - This is a sample XML script to return the status of TPM
  • 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.
  • HD_Zone_Defaults.xml - Reset the Hard Drive Zoning to factory defaults for XL servers that support hard drive zoning.
  • HD_Zone_ReadBackplaneInfo.xml - Read the Hard Drive Backplane Information from XL servers that support hard drive zoning.
  • HD_Zone_ReadZoneTable.xml - Read the Hard Drive Zoning for XL servers that support hard drive zoning.
  • HD_Zone_Write_Zone.xml - Write the Hard Drive Zoning Information to XL servers that support hard drive zoning.
  • Hotkey_Config.xml - Change the values for Remote Console hotkeys.
  • hponcfg_reformat.xsl - The style-sheet (.xsl) converts the iLO configuration captured using hponcfgcap.xml to a format that can be used to restore the configuration of iLO.
  • hponcfgcap.xml - Capture the current iLO configuration such as Global Settings,Network Settings, Users Information and Directory Settings to a file using HPONCFG.
  • ilo_perl_xml.pdf - Document PERL script usage.
  • Import_Cert.xml - Import a signed certificate into a Lights-Out device.
  • Import_LDAP_CA_Cert.xml - Import LDAP CA 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.
  • locfg.pl - Sample PERL script to send XML commands.
  • Lock_Configuration.xml - Enable/disable the datacenter configuration lock.
  • Mod_Directory.xml - Change the directory settings of an Lights-Out device.
  • Mod_Encrypt_Settings - This is a sample XML script to configure the encryption Settings
  • Mod_Federation_Group.xml - This is a sample XML script to modify a Federation group membership and associated privileges       
  • Mod_Global_Settings.xml - Change the Lights-Out device Global Settings.
  • Mod_Kerberos_Config.xml - To configure kerberos configuration.
  • 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 HPE 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.
  • Mod_VM_Port_Settings.xml - This is a sample XML script to configure the virtual media port functionality on iLO.
  • Profile_Apply.xml - This is a sample XML script to set the Profile Descriptor.
  • Profile_Apply_Get_Results.xml - This is a sample XML script to get the results from the Profile_Apply.
  • Profile_Desc_Delete.xml - This is a sample XML script to delete the Profile Descriptor.  
  • Profile_Desc_Download.xml - This is a sample XML script to write a profile Description, download a specific blob and write the blob to the blobstore.
  • Profile_Desc_List.xml -  This is a sample XML script to list all the Profile Descriptors and the data stored in the Profile Descriptor.
  • 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_AHS_Status.xml - This is a sample XML script to enable or disable AHS logging.
  • Set_Asset_tag.xml - This is a sample XML script to set the asset tag, asset tag limited to 32 characters.
  • Set_Boot_Mode.xml - This is a sample XML script to set the pending boot mode.
  • Set_Brownout.xml - This is a sample XML script to enable or disable brownout support.
  • Set_Federation_Multicast_Options.xml - This is a sample XML script to set the Federation multicast options.
  • Set_FIPS_Enable.xml - This is a sample XML script to enable FIPs mode.
  • Set_Host_APO.xml - Change server automatic power on and power on delay settings.
  • Set_Host_CTRO.xml - To set the critical temperature shutdown behavior of a server.
  • Set_Host_Power.xml - Power on/off the host server.
  • Set_Host_Power_Saver.xml - Change the Power Regulator setting.
  • Set_Language.xml - This is a sample XML script to set the default language on iLO.
  • Set_One_Time_Boot_Order.xml - This is a sample XML script to Set One Time Boot Order.
  • Set_Persistent_Boot_Order.xml - This is a sample XML script to Set Persistent Boot Order.
  • Set_Persmouse_Status.xml - Set the persistent mouse and keyboard.
  • Set_PowerCap.xml - Change the Power Cap setting.
  • Set_Pwreg_Alert_Threshold.xml - Change the power alert threshold settings.
  • Set_Security_Msg.xml - This is a sample XML script to configure a security text message in the iLO Login Banner.
  • Set_Server_Name.xml - Set the host server name.
  • Set_Server_FQDN.xml - This is a sample XML script to set the host server FQDN.
  • Set_Virtual_Power_BTN.xml - This is a sample XML script to simulate physical press of the server power button, cold boot and warm boot.
  • Set_VM_Status.xml - This is a sample XML script to configure the virtual media boot options.
  • Shared_Network_Port.xml - Configure Lights-Out device to pass network traffic on the shared host network port on supported platforms.
  • Start_Directory_Test.xml - This is a sample XML script to start directory tests.
  • 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.
  • Update_Language.xml - Script to update the language pack.
  • vspconfig.pl - Set the Virtual Serial Port Configuration for Linux.
  • windows-LOsamplescripts5.10.0.txt - README file.

The HPQLOCFG utility connects to the iLO management processor using a 128-bit Secure Sockets Layer (SSL) connection where:

HPQLOCFG -s {servername|ipaddress}[:port] [-l logfilename] -f input_filename [-v] [-c] [-u username -p password]

  • -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
  • -v Enables verbose message logging. By default, only errors and responses from GET commands will be logged without the -v switch.
  • -c Will cause HPQLOCFG to check for correct xml formatting, but not open a connection to the management processor.
  • -u username
  • -p password

Note: Command line user name and password override those which are in the script file.


End User License Agreements:
HPE Software License Agreement v1


Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


Notes:

Documentation:
Integrated Lights-Out 5 User Guide, Integrated Lights-Out 4 User Guide, Integrated Lights-Out 3 User Guide and iLO Scripting and Command Line Guide can be found by following the link at: http://www.hpe.com/info/ilo/docs.

Use HPQLOCFG.EXE ver 1.00 or greater with these scripts.

 

 

See "iLO Scripting and Command Line Guide" for more information on scripting and the syntax of the RIBCL XML.


Version:5.10.0 (16 Jan 2018)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


Added Get_PS_Data.xml to sample script bundle.


Version:5.00.0 (12 Jul 2017)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


iLO 5 support introduced in LOCFG.pl.


Version:4.91.0 (15 May 2017)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


Support for iLO 4 v2.53 firmware -

  • Ability to enable Generic LDAP from Mod_Directory.xml
  • Ability to Import LDAP CA certificate into an iLO using Import_LDAP_CA_Cert.xml
  • Ability to get LDAP CA certificate status using Get_LDAP_CA_Cert_Status.xml

Version:4.90.0 (24 Oct 2016)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


Added a new tag to Mod_Network_Settings.xml

  • IPMI_DCMI_OVER_LAN_PORT

Version:4.80.0 (1 Apr 2016)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


Added support to set or get the critical temperature shutdown behavior of a server

  • Set_Host_CTRO.xml
  • Get_Host_CTRO.xml

Added support to perform Directory Tests

  • Start_Directory_Test.xml
  • Get_Directory_Test_Results.xml
  • Abort_Directory_test.xml

Added 4 new tags to Mod_Network_Settings.xml

  • ILO_NIC_AUTO_SNP_SCAN
  • ILO_NIC_AUTO_DELAY
  • ILO_NIC_FAIL_OVER
  • ILO_NIC_FAIL_OVER_DELAY

Version:4.70.0 (1 Oct 2015)
Fixes

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


  • AUTHENTICATION_FAILURE_DELAY_SECS, AUTHENTICATION_FAILURES_BEFORE_DELAY and LOCK_CONFIGURATION tags added to Mod_Global_Settings.xml

Version:4.60.0 (15 Jun 2015)
Fixes

Upgrade Requirement:
Recommended - HPE recommends users update to this version at their earliest convenience.


  • Improved error handling for script execution in LOCFG.pl
Enhancements

  • Introduced FEDERATION_ENABLE tag in Set_Federation_Multicast_Options.xml
  • 4 new scripts added for Hard Drive zoning - HD_Zone_Defaults.xml, HD_Zone_ReadBackplaneInfo.xml, HD_Zone_ReadZoneTable.xml and HD_Zone_Write_Zone.xml

Version:4.50.0 (30 Mar 2015)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


- Introduced SNP_PORT tag in Shared_Network_Port.xml
- Added DHCPV6_DOMAIN_NAME and ILO_NIC_AUTO_SELECT tags in Mod_Network_Settings.xml
- SSL_V3_ENABLE tag for iLO2 Management Processor is included in MOD_GLOBAL_SETTINGS.xml
- Result of script execution gets printed at the end of each run in LOCFG.PL
- 2 new scripts added - Get_SDCard_Status.xml and Send_Snmp_Test_Trap.xml


Version:4.40.0 (9 Sep 2014)
Fixes

Upgrade Requirement:
Recommended - HP recommends users update to this version at their earliest convenience.


LOCFG.PL supports iLO fully qualified domain name(FQDN) with –s option


Version:4.30.0 (18 Feb 2014)
Fixes

Upgrade Requirement:
Recommended - HP recommends users update to this version at their earliest convenience.


None

Enhancements

New scripts added:

  • Add_Federation_Group.xml
  • Delete_Federation_Group.xml
  • ERS_DC_CompleteRegistration.xml
  • ERS_DC_RegisterDevice.xml
  • Get_Boot_Mode.xml
  • Get_Current_Boot_Mode.xml
  • Get_Federation_All_Groups.xml
  • Get_Federation_All_Groups_Info.xml
  • Get_Federation_Group.xml
  • Get_Federation_Multicast_Options.xml
  • Get_Supported_Boot_Mode.xml
  • Get_TPM_Status.xml
  • Mod_Federation_Group.xml
  • Set_Federation_Multicast_Options.xml
  • Set_Boot_Mode.xml
  • Set_Persistent_Boot_Order.xml

Version:4.20.0 (10 Sep 2013)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


New scripts added:

  • Get_Embedded_Health.xml
  • Get_Persmouse_Status.xml
  • Get_Product_Name.xml
  • Set_Persmouse_Status.xml
  • Update_Language.xml

Version:4.12.0 (13 May 2013)
Fixes

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


None

Enhancements

Added the following scripts:

  • Set_Persmouse_Status.xml
  • Get_Persmouse_Status.xml

Version:4.11.0 (19 Feb 2013)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


  • New scripts added:
    • Get_Server_FQDN.xml - This is a sample XML script to get the host server Fully Qualified Domain Name.
    • Set_Server_FQDN.xml - This is a sample XML script to set the host server Fully Qualified Domain Name.
    • Get_Rack_Settings.xml - This is a sample XML script to return enclosure data for c-Class Blade infrastructure.
    • Get_All_Licenses.xml - This is a sample XML script to get the license information.
    • Set_Fips_Enable.xml - This is a sample XML script to enable FIPS mode.
    • Get_Fips_Status.xml - This is a sample XML script to return the current FIPS Mode
       
  • New tags added for supporting the following features:
    • New tags added in Mod_Global_Settings.xml to set Remote Syslog and Alert Mail in iLO 4.
    • New tags added in Mod_SNMP_IM_Setttings.xml to set SNMP traps.

Version:4.10.0 (24 Sep 2012)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


  • New scripts added:
    • Set_Security_Msg.xml & Get_Security_Msg.xml scripts to retrieve / configure the current security text message set in the iLO Login Banner.
    • Set_FIPS_Enable.xml & Get_FIPS_Status.xml scripts are added to enable FIP’s mode / retrieve current FIP’s Mode in iLO
    • Hotkey_Config.xml - to configure a set of Remote Console hotkeys for iLO
    • Get_Hotkey_Config.xml - to get the Remote Console hotkeys from iLO.
    • Delete_SSH_Key.xml - deletes existing SSH key saved for the user that is referred by the USER_LOGIN value.
    • Cert_Request.xml - to get a certificate signing request from iLO.
    • Profile_Apply.xml - set the Profile Descriptor in iLO.
    • Profile_Apply_Get_Results.xml - to get the results from the Profile_Apply.
    • Profile_Desc_Delete.xml - to delete the Profile Descriptor.
    • Profile_Desc_List.xml - to list all the Profile Descriptors and the data stored in the Profile Descriptor.
    • Profile_Desc_Download.xml - to write a Profile Description, download a specific blob and write the blob to the blob store. 
  • New tags added for supporting the following features:
    • New tags added in Mod_Global_Settings.xml to set the value for SNMP port and SNMP trap port in iLO.
    • New tags added in Mod_Network_Settings.xml for configuring IPv6 network settings.

Version:4.00.0 (16 Apr 2012)
Enhancements

Upgrade Requirement:
Recommended - HP recommends users update to this version at their earliest convenience.


  • Added scripts to support iLO 4.    

Version:3.10.0 (9 Jun 2011)
Enhancements

Upgrade Requirement:
Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


New Scripts Added:

Mod_Kerberos_Config.xml
  • Set_Fqdn.xml
  • Set_default_language.xml
  • Set_One_Time_Boot_Order.xml
  • Set_Persistent_Boot_Order.xml
  • Get_language.xml
  • Get_One_Time_Boot_Order.xml
  • Get_Persistent_Boot_Order.xml
  • Delete_SSH_Key.xml
  • Set_CSR_Custom.xml
  • Set_CSR_Default.xml 
  • Get_Cert_Subject.xml
  • Mod_ConsoleCapture_Port_Settings.xml
  • Mod_VM_Port_Settings.xml
  •  


    Version:3.0.0-2 (26 May 2010)
    Enhancements

    Upgrade Requirement:
    Recommended - HP recommends users update to this version at their earliest convenience.


    Provided Support for Integrated Lights-Out 3 (iLO3)

    New Script added:
       - 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


    Version:2.40.0-1 (7 May 2009)
    Enhancements
    Added the following sample scripts:
    • Import_SSH_Key.xml
    • Get_Host_Pwr_Micro_Ver.xml

    Added the following configuration options to Mod_Global_Settings.xml:

    • KEY_UP_KEY_DOWN
    • CAPTURE_MANUAL_EXPORT

    Added the following option to Update_Firmware.xml

    • TPM_ENABLED

    Added the following option to Mod_Directory.xml

    • DIR_USER_CONTEXT_X

    where X can be from 4 to 15.


    Version:2.20.0-1 (26 Jul 2007)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    New support for iLO 2 v1.30.

    Added following sample scripts:

    • Add_SSO_Rec.xml
    • Add_SSO_Settings.xml
    • Mod_SSO_Settings.xml
    • Add_SSO_Rec.xml
    • Delete_SSO_Rec.xml
    • Clear_IML.xml
    • Computer_Lock_Config.xml
    • Get_PowerCap.xml
    • Get_Server_Name.xml
    • Set_Server_Name.xml
    • Set_PowerCap.xml
    Added following commands to Mod_Global_Settings.xml:
    • ENFORCE_AES
    • AUTHENTICATION_FAILURE_LOGGINS
    • CONSOLE_CAPTURE_ENABLE
    • CONSOLE_CAPTURE_BOOT_BUFFER_ENABLE
    • CONSOLE_CAPTURE_FAULT_BUFFER_ENABLE
    • INTERACTIVE_CONSOLE_REPLAY_ENABLE
    • CONSOLE_CAPTURE_PORT
    • CAPTURE_AUTO_EXPORT_ENABLE
    • CAPTURE_AUTO_EXPORT_LOCATION
    • CAPTURE_AUTO_EXPORT_USERNAME
    • CAPTURE_AUTO_EXPORT_PASSWORD
    • SHARED_CONSOLE_ENABLE
    • SHARED_CONSOLE_PORT
    Added locfg.pl command line options "-u username" and "-p password".
  • Note: Use "-u" and "-p" with caution as comamnd line options are visible on Linux.

  • Version:2.10.0-1 (12 Jul 2006)
    Fixes

    Upgrade Requirement:
    Recommended - HPE recommends users update to this version at their earliest convenience.


    Fixed tag names for ILO 2 in Mod_VLAN.xml.

    Enhancements

    New support for iLO 2 v1.1x and v1.20.

    Added following sample scripts:

    • Copy_Virtual_Floppy.xml
    • Get_All_Cables_Status.xml
    • Get_EmHealth.xml
    • Get_Host_APO.xml
    • Get_Power_Readings.xml
    • Get_VPB_Cable_Status.xml
    • Set_Host_APO.xml

    Version:2.00.0-1 (2 Feb 2006)
    Fixes

    Upgrade Requirement:
    Recommended - HPE recommends users update to this version at their earliest convenience.


    Added sample script for set_host_power
    Updated get_ilo_log to not use RIB info mode write Fixes typos in scripts.

    Enhancements

    New support for iLO 2 v1.0x and RILOE-II v1.20.


    Version:1.80.0-1 (14 Jul 2005)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    The following scripts have been added or modified to support additional firmware features available in 1.80:

    Mod_VLAN.xml
    Mod_Schemaless_Directory.xml
    Get_Host_Pwr_Reg_Info.xml
    Mod_2Factor.xml
    Import_2Factor_Certs.xml
    Get_2Factor.xml


    Version:1.70.0-1 (13 Apr 2005)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    The following scripts have been added or modified to support additional firmware features available in 1.70:
    NEW SAMPLE SCRIPTS
    Get_Host_Power_Saver.xml
    Set_Host_Power_Saver.xml


    Version:1.64.0-1 (24 Nov 2004)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    The following scripts have been added or modified to support additional firmware features available in 1.64:

    • Cert_Request.xml

    • Import_Cert.xml

    Version:1.60 (16 Jul 2004)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    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.


    Version:1.5 (23 Jan 2004)
    Enhancements
    Updated with new iLO v1.50 scripting commands.

    Type: Software - Lights-Out Management
    Version: 5.10.0(16 Jan 2018)
    Operating System(s):
    Microsoft Windows 10 (32-bit)
    Microsoft Windows 10 (64-bit)
    Microsoft Windows 7 (32-bit)
    Microsoft Windows 7 (64-bit)
    Microsoft Windows 8 (32-bit)
    Microsoft Windows 8 (64-bit)
    Microsoft Windows 8.1 (32-bit)
    Microsoft Windows 8.1 (64-bit)
    Microsoft Windows Server 2008 R2
    Microsoft Windows Server 2008 W32
    Microsoft Windows Server 2008 x64
    Microsoft Windows Server 2012
    Microsoft Windows Server 2012 Essentials
    Microsoft Windows Server 2012 R2
    Microsoft Windows Server 2016
    Microsoft Windows Server 2019

    Description

    The HPE Lights-Out management processors support an advanced scripting interface for group configuration and server actions. The scripting capability of the iLO provides an easy and efficient way to configure and maintain management processors in large scale IT environments, saving time and costs. The Lights-Out Configuration Utility can be used to configure iLO 5, iLO 4 and iLO 3.

    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    Added Get_PS_Data.xml to sample script bundle.

    Installation Instructions

    Prerequisites:

    Use HP Lights-Out Configuration Utility (HPQLOCFG.EXE) ver 1.0.0 or greater with these scripts.
    Note: HP Lights-Out Configuration Utility may be downloaded from www.hpe.com/info/iLO, TOOLS under Resources section.

    A valid iLO user account and password is required for each XML script when using HPQLOCFG. The user account must have appropriate Lights-Out privileges to process the request.


    To ensure the integrity of your download, HPE recommends verifying your results with this SHA-256 Checksum value:

    063fefff959ebbd61b64804fc80cd891ee0bd703c709e3306fb30b3e9d816dec windows-LOsamplescripts5.10.0.zip

    Reboot Requirement:
    Reboot is not required after installation for updates to take effect and hardware stability to be maintained.


    Installation:

    1. Download and install the HP Lights-Out Configuration Utility (HPQLOCFG.EXE) on your client system.
    2. Then, download and unzip the HPE Lights-Out Scripting Sample file and modify these sample scripts.
    3. Run the HPQLOCFG program in a batch process or using Systems Insight Manager.

    This zip file contains the following scripts:

    • Abort_Directory_test.xml - This is a sample XML script to abort ongoing directory test.
    • Add_Federation_Group.xml - This is a sample XML script to add a Federation group membership and grant associated privileges
    • Add_SSO_Rec.xml - Add an HPE 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_AHS_Data.xml - Clear the AHS data. 
    • Clear_EventLog.xml - Clear the Light-Out device Event Log.
    • Clear_IML.xml - Clear the server Integrated Management Log (IML).
    • Clear_Power_On_Time.xml - Clear the power-on time counter.
    • Computer_Lock_Config.xml - Change the values for Computer Lock settings.
    • Delete_Federation_Group.xml - This is a sample XML script to delete a Federation group membership
    • Delete_SSH_Key.xml - This is a sample XML script that deletes existing SSH key.
    • Delete_SSO_Rec.xml - Delete an HPE 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.
    • ERS_AHS_Submit.xml - This is a sample XML script to initiate AHS data submission to IRS.
    • ERS_DC_CompleteRegistration.xml - This is a sample XML script to complete the server registration.
    • ERS_DC_RegisterDevice.xml - This is a sample XML script to connect ERS to Insight Online and perform the 1st step of server registration.
    • ERS_DC_SetWebProxy.xml - This is a sample XML script to modify the Web Proxy information required by  ERS to communicate with Insight Online.
    • ERS_Disable.xml - This is a sample XML script to disable iLO ERS functionality and un-register the server.
    • ERS_Get_Settings.xml - This is a sample XML script to retrieve current ERS settings.
    • ERS_IRS_Enable.xml - This is a sample XML script to connect ERS to Insight Remote Support server (IRS) and register the server.
    • ERS_L2_Collection_Submit.xml - This is a sample XML script to initiate a L2 data collection submission to IRS.
    • ERS_Test_Event_Submit.xml - This is a sample XML script to initiate a test service event submission to IRS.
    • Factory_Defaults.xml - Sets the Lights-out device to factory default settings.
    • Get_AHS_Status.xml - This is a sample XML script to find out if AHS is enabled or disabled.
    • Get_All_Languages.xml - This is a sample XML script to read all languages that are supported on iLO.
    • Get_All_Licenses.xml - This is a sample XML script to get the license information.
    • 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_Asset_Tag.xml - This is a sample XML script to get the asset tag.
    • Get_Boot_Mode.xml - This is a sample XML script to get the pending boot mode.
    • Get_Current_Boot_Mode.xml - This is a sample XML script to get the current boot mode.             
    • Get_Directory.xml - Return the current directory configuration of an Lights-Out device.
    • Get_Directory_Test_Results.xml - This is a sample XML script to get directory test results.
    • Get_discovery_services.xml - This is a sample XML script to read location discovery Services data.
    • Get_EmHealth.xml - Return the health information of the server.
    • Get_Embedded_health.xml - Retrieves health information of the server.
    • Get_Encrypt.xml - This is a sample XML script to return current encryption settings
    • Get_Federation_Group.xml - This is a sample XML script to retrieve the privileges granted to a specified Federation
    • Get_Federation_All_Groups.xml - This is a sample XML script to retrieve a list of all Federation group memberships
    • Get_Federation_All_Groups_Info.xml - This is a sample XML script to retrieve a list of all Federation group memberships and granted privileges
    • Get_Federation_Multicast_Options.xml - This is a sample XML script to retrieve the current Federation multicast options.
    • Get_FIPS_Status.xml - Return the status of FIPs mode.
    • 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_CTRO.xml - To get the critical temperature shutdown behavior of a server.
    • 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_Host_Pwr_Micro_Ver.xml - Power Micro Firmware revision information of the server.
    • Get_Hotkey_Config.xml - Retrieve the Remote Console hotkeys.
    • 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_language.xml - This is a sample XML script to get the default language setting and to retrieve the list of installed languages.
    • Get_LDAP_CA_Cert_Status.xml - Return LDAP CA certificate status.
    • Get_Network.xml - Return network settings.
    • Get_OA_Info.xml - Return enclosure data for c-Class Blade Infrastructure.
    • Get_One_Time_Boot_Order.xml - This is a sample XML script to retrieve the current State of the One Time Boot.
    • Get_Persistent_Boot_Order.xml - This is a sample XML script to retrieve the current State of the Boot Order.
    • Get_Persmouse_Status.xml  - Get the persistent mouse and keyboard status.         
    • Get_Power_On_Time.xml - Return the number of minutes the server has been powered on and running.
    • Get_Power_Readings.xml: Return the power readings from the server.
    • Get_PowerCap.xml - Return Power Cap setting.
    • Get_Product_name.xml -  Get the product name.
    • Get_PS_Data.xml -  Return the power supply information of the server.
    • Get_Pwreg_Alert_Threshold.xml - Return the current power alert threshold settings.
    • Get_Rack_Settings.xml - This is a sample XML script to return enclosure data for c-Class blade infrastructure
    • Get_Security_Msg.xml - This is a sample XML script to retrieve the current security text message set in the iLO Login Banner.
    • Get_Server_Name.xml - Return the host server name.
    • Get_Server_FQDN.xml - This is a sample XML script to get the host server FQDN.
    • Get_SNMP_IM.xml - Return the current SNMP and Insight Manager security settings.
    • Get_SSO_Settings.xml - Retrieve the HPE SIM Single Sign-On (SSO) settings.
    • Get_Supported_Boot_Mode.xml - This is a sample XML script to get the supported boot mode(s).
    • Get_TPM_Status.xml - This is a sample XML script to return the status of TPM
    • 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.
    • HD_Zone_Defaults.xml - Reset the Hard Drive Zoning to factory defaults for XL servers that support hard drive zoning.
    • HD_Zone_ReadBackplaneInfo.xml - Read the Hard Drive Backplane Information from XL servers that support hard drive zoning.
    • HD_Zone_ReadZoneTable.xml - Read the Hard Drive Zoning for XL servers that support hard drive zoning.
    • HD_Zone_Write_Zone.xml - Write the Hard Drive Zoning Information to XL servers that support hard drive zoning.
    • Hotkey_Config.xml - Change the values for Remote Console hotkeys.
    • hponcfg_reformat.xsl - The style-sheet (.xsl) converts the iLO configuration captured using hponcfgcap.xml to a format that can be used to restore the configuration of iLO.
    • hponcfgcap.xml - Capture the current iLO configuration such as Global Settings,Network Settings, Users Information and Directory Settings to a file using HPONCFG.
    • ilo_perl_xml.pdf - Document PERL script usage.
    • Import_Cert.xml - Import a signed certificate into a Lights-Out device.
    • Import_LDAP_CA_Cert.xml - Import LDAP CA 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.
    • locfg.pl - Sample PERL script to send XML commands.
    • Lock_Configuration.xml - Enable/disable the datacenter configuration lock.
    • Mod_Directory.xml - Change the directory settings of an Lights-Out device.
    • Mod_Encrypt_Settings - This is a sample XML script to configure the encryption Settings
    • Mod_Federation_Group.xml - This is a sample XML script to modify a Federation group membership and associated privileges       
    • Mod_Global_Settings.xml - Change the Lights-Out device Global Settings.
    • Mod_Kerberos_Config.xml - To configure kerberos configuration.
    • 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 HPE 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.
    • Mod_VM_Port_Settings.xml - This is a sample XML script to configure the virtual media port functionality on iLO.
    • Profile_Apply.xml - This is a sample XML script to set the Profile Descriptor.
    • Profile_Apply_Get_Results.xml - This is a sample XML script to get the results from the Profile_Apply.
    • Profile_Desc_Delete.xml - This is a sample XML script to delete the Profile Descriptor.  
    • Profile_Desc_Download.xml - This is a sample XML script to write a profile Description, download a specific blob and write the blob to the blobstore.
    • Profile_Desc_List.xml -  This is a sample XML script to list all the Profile Descriptors and the data stored in the Profile Descriptor.
    • 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_AHS_Status.xml - This is a sample XML script to enable or disable AHS logging.
    • Set_Asset_tag.xml - This is a sample XML script to set the asset tag, asset tag limited to 32 characters.
    • Set_Boot_Mode.xml - This is a sample XML script to set the pending boot mode.
    • Set_Brownout.xml - This is a sample XML script to enable or disable brownout support.
    • Set_Federation_Multicast_Options.xml - This is a sample XML script to set the Federation multicast options.
    • Set_FIPS_Enable.xml - This is a sample XML script to enable FIPs mode.
    • Set_Host_APO.xml - Change server automatic power on and power on delay settings.
    • Set_Host_CTRO.xml - To set the critical temperature shutdown behavior of a server.
    • Set_Host_Power.xml - Power on/off the host server.
    • Set_Host_Power_Saver.xml - Change the Power Regulator setting.
    • Set_Language.xml - This is a sample XML script to set the default language on iLO.
    • Set_One_Time_Boot_Order.xml - This is a sample XML script to Set One Time Boot Order.
    • Set_Persistent_Boot_Order.xml - This is a sample XML script to Set Persistent Boot Order.
    • Set_Persmouse_Status.xml - Set the persistent mouse and keyboard.
    • Set_PowerCap.xml - Change the Power Cap setting.
    • Set_Pwreg_Alert_Threshold.xml - Change the power alert threshold settings.
    • Set_Security_Msg.xml - This is a sample XML script to configure a security text message in the iLO Login Banner.
    • Set_Server_Name.xml - Set the host server name.
    • Set_Server_FQDN.xml - This is a sample XML script to set the host server FQDN.
    • Set_Virtual_Power_BTN.xml - This is a sample XML script to simulate physical press of the server power button, cold boot and warm boot.
    • Set_VM_Status.xml - This is a sample XML script to configure the virtual media boot options.
    • Shared_Network_Port.xml - Configure Lights-Out device to pass network traffic on the shared host network port on supported platforms.
    • Start_Directory_Test.xml - This is a sample XML script to start directory tests.
    • 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.
    • Update_Language.xml - Script to update the language pack.
    • vspconfig.pl - Set the Virtual Serial Port Configuration for Linux.
    • windows-LOsamplescripts5.10.0.txt - README file.

    The HPQLOCFG utility connects to the iLO management processor using a 128-bit Secure Sockets Layer (SSL) connection where:

    HPQLOCFG -s {servername|ipaddress}[:port] [-l logfilename] -f input_filename [-v] [-c] [-u username -p password]

    • -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
    • -v Enables verbose message logging. By default, only errors and responses from GET commands will be logged without the -v switch.
    • -c Will cause HPQLOCFG to check for correct xml formatting, but not open a connection to the management processor.
    • -u username
    • -p password

    Note: Command line user name and password override those which are in the script file.


    Release Notes

    End User License Agreements:
    HPE Software License Agreement v1


    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    Notes:

    Documentation:
    Integrated Lights-Out 5 User Guide, Integrated Lights-Out 4 User Guide, Integrated Lights-Out 3 User Guide and iLO Scripting and Command Line Guide can be found by following the link at: http://www.hpe.com/info/ilo/docs.

    Use HPQLOCFG.EXE ver 1.00 or greater with these scripts.

     

     

    See "iLO Scripting and Command Line Guide" for more information on scripting and the syntax of the RIBCL XML.


    Revision History

    Version:5.10.0 (16 Jan 2018)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    Added Get_PS_Data.xml to sample script bundle.


    Version:5.00.0 (12 Jul 2017)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    iLO 5 support introduced in LOCFG.pl.


    Version:4.91.0 (15 May 2017)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    Support for iLO 4 v2.53 firmware -

    • Ability to enable Generic LDAP from Mod_Directory.xml
    • Ability to Import LDAP CA certificate into an iLO using Import_LDAP_CA_Cert.xml
    • Ability to get LDAP CA certificate status using Get_LDAP_CA_Cert_Status.xml

    Version:4.90.0 (24 Oct 2016)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    Added a new tag to Mod_Network_Settings.xml

    • IPMI_DCMI_OVER_LAN_PORT

    Version:4.80.0 (1 Apr 2016)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    Added support to set or get the critical temperature shutdown behavior of a server

    • Set_Host_CTRO.xml
    • Get_Host_CTRO.xml

    Added support to perform Directory Tests

    • Start_Directory_Test.xml
    • Get_Directory_Test_Results.xml
    • Abort_Directory_test.xml

    Added 4 new tags to Mod_Network_Settings.xml

    • ILO_NIC_AUTO_SNP_SCAN
    • ILO_NIC_AUTO_DELAY
    • ILO_NIC_FAIL_OVER
    • ILO_NIC_FAIL_OVER_DELAY

    Version:4.70.0 (1 Oct 2015)
    Fixes

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    • AUTHENTICATION_FAILURE_DELAY_SECS, AUTHENTICATION_FAILURES_BEFORE_DELAY and LOCK_CONFIGURATION tags added to Mod_Global_Settings.xml

    Version:4.60.0 (15 Jun 2015)
    Fixes

    Upgrade Requirement:
    Recommended - HPE recommends users update to this version at their earliest convenience.


    • Improved error handling for script execution in LOCFG.pl
    Enhancements

    • Introduced FEDERATION_ENABLE tag in Set_Federation_Multicast_Options.xml
    • 4 new scripts added for Hard Drive zoning - HD_Zone_Defaults.xml, HD_Zone_ReadBackplaneInfo.xml, HD_Zone_ReadZoneTable.xml and HD_Zone_Write_Zone.xml

    Version:4.50.0 (30 Mar 2015)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    - Introduced SNP_PORT tag in Shared_Network_Port.xml
    - Added DHCPV6_DOMAIN_NAME and ILO_NIC_AUTO_SELECT tags in Mod_Network_Settings.xml
    - SSL_V3_ENABLE tag for iLO2 Management Processor is included in MOD_GLOBAL_SETTINGS.xml
    - Result of script execution gets printed at the end of each run in LOCFG.PL
    - 2 new scripts added - Get_SDCard_Status.xml and Send_Snmp_Test_Trap.xml


    Version:4.40.0 (9 Sep 2014)
    Fixes

    Upgrade Requirement:
    Recommended - HP recommends users update to this version at their earliest convenience.


    LOCFG.PL supports iLO fully qualified domain name(FQDN) with –s option


    Version:4.30.0 (18 Feb 2014)
    Fixes

    Upgrade Requirement:
    Recommended - HP recommends users update to this version at their earliest convenience.


    None

    Enhancements

    New scripts added:

    • Add_Federation_Group.xml
    • Delete_Federation_Group.xml
    • ERS_DC_CompleteRegistration.xml
    • ERS_DC_RegisterDevice.xml
    • Get_Boot_Mode.xml
    • Get_Current_Boot_Mode.xml
    • Get_Federation_All_Groups.xml
    • Get_Federation_All_Groups_Info.xml
    • Get_Federation_Group.xml
    • Get_Federation_Multicast_Options.xml
    • Get_Supported_Boot_Mode.xml
    • Get_TPM_Status.xml
    • Mod_Federation_Group.xml
    • Set_Federation_Multicast_Options.xml
    • Set_Boot_Mode.xml
    • Set_Persistent_Boot_Order.xml

    Version:4.20.0 (10 Sep 2013)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    New scripts added:

    • Get_Embedded_Health.xml
    • Get_Persmouse_Status.xml
    • Get_Product_Name.xml
    • Set_Persmouse_Status.xml
    • Update_Language.xml

    Version:4.12.0 (13 May 2013)
    Fixes

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    None

    Enhancements

    Added the following scripts:

    • Set_Persmouse_Status.xml
    • Get_Persmouse_Status.xml

    Version:4.11.0 (19 Feb 2013)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    • New scripts added:
      • Get_Server_FQDN.xml - This is a sample XML script to get the host server Fully Qualified Domain Name.
      • Set_Server_FQDN.xml - This is a sample XML script to set the host server Fully Qualified Domain Name.
      • Get_Rack_Settings.xml - This is a sample XML script to return enclosure data for c-Class Blade infrastructure.
      • Get_All_Licenses.xml - This is a sample XML script to get the license information.
      • Set_Fips_Enable.xml - This is a sample XML script to enable FIPS mode.
      • Get_Fips_Status.xml - This is a sample XML script to return the current FIPS Mode
         
    • New tags added for supporting the following features:
      • New tags added in Mod_Global_Settings.xml to set Remote Syslog and Alert Mail in iLO 4.
      • New tags added in Mod_SNMP_IM_Setttings.xml to set SNMP traps.

    Version:4.10.0 (24 Sep 2012)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    • New scripts added:
      • Set_Security_Msg.xml & Get_Security_Msg.xml scripts to retrieve / configure the current security text message set in the iLO Login Banner.
      • Set_FIPS_Enable.xml & Get_FIPS_Status.xml scripts are added to enable FIP’s mode / retrieve current FIP’s Mode in iLO
      • Hotkey_Config.xml - to configure a set of Remote Console hotkeys for iLO
      • Get_Hotkey_Config.xml - to get the Remote Console hotkeys from iLO.
      • Delete_SSH_Key.xml - deletes existing SSH key saved for the user that is referred by the USER_LOGIN value.
      • Cert_Request.xml - to get a certificate signing request from iLO.
      • Profile_Apply.xml - set the Profile Descriptor in iLO.
      • Profile_Apply_Get_Results.xml - to get the results from the Profile_Apply.
      • Profile_Desc_Delete.xml - to delete the Profile Descriptor.
      • Profile_Desc_List.xml - to list all the Profile Descriptors and the data stored in the Profile Descriptor.
      • Profile_Desc_Download.xml - to write a Profile Description, download a specific blob and write the blob to the blob store. 
    • New tags added for supporting the following features:
      • New tags added in Mod_Global_Settings.xml to set the value for SNMP port and SNMP trap port in iLO.
      • New tags added in Mod_Network_Settings.xml for configuring IPv6 network settings.

    Version:4.00.0 (16 Apr 2012)
    Enhancements

    Upgrade Requirement:
    Recommended - HP recommends users update to this version at their earliest convenience.


    • Added scripts to support iLO 4.    

    Version:3.10.0 (9 Jun 2011)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    New Scripts Added:

    Mod_Kerberos_Config.xml
  • Set_Fqdn.xml
  • Set_default_language.xml
  • Set_One_Time_Boot_Order.xml
  • Set_Persistent_Boot_Order.xml
  • Get_language.xml
  • Get_One_Time_Boot_Order.xml
  • Get_Persistent_Boot_Order.xml
  • Delete_SSH_Key.xml
  • Set_CSR_Custom.xml
  • Set_CSR_Default.xml 
  • Get_Cert_Subject.xml
  • Mod_ConsoleCapture_Port_Settings.xml
  • Mod_VM_Port_Settings.xml
  •  


    Version:3.0.0-2 (26 May 2010)
    Enhancements

    Upgrade Requirement:
    Recommended - HP recommends users update to this version at their earliest convenience.


    Provided Support for Integrated Lights-Out 3 (iLO3)

    New Script added:
       - 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


    Version:2.40.0-1 (7 May 2009)
    Enhancements
    Added the following sample scripts:
    • Import_SSH_Key.xml
    • Get_Host_Pwr_Micro_Ver.xml

    Added the following configuration options to Mod_Global_Settings.xml:

    • KEY_UP_KEY_DOWN
    • CAPTURE_MANUAL_EXPORT

    Added the following option to Update_Firmware.xml

    • TPM_ENABLED

    Added the following option to Mod_Directory.xml

    • DIR_USER_CONTEXT_X

    where X can be from 4 to 15.


    Version:2.20.0-1 (26 Jul 2007)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    New support for iLO 2 v1.30.

    Added following sample scripts:

    • Add_SSO_Rec.xml
    • Add_SSO_Settings.xml
    • Mod_SSO_Settings.xml
    • Add_SSO_Rec.xml
    • Delete_SSO_Rec.xml
    • Clear_IML.xml
    • Computer_Lock_Config.xml
    • Get_PowerCap.xml
    • Get_Server_Name.xml
    • Set_Server_Name.xml
    • Set_PowerCap.xml
    Added following commands to Mod_Global_Settings.xml:
    • ENFORCE_AES
    • AUTHENTICATION_FAILURE_LOGGINS
    • CONSOLE_CAPTURE_ENABLE
    • CONSOLE_CAPTURE_BOOT_BUFFER_ENABLE
    • CONSOLE_CAPTURE_FAULT_BUFFER_ENABLE
    • INTERACTIVE_CONSOLE_REPLAY_ENABLE
    • CONSOLE_CAPTURE_PORT
    • CAPTURE_AUTO_EXPORT_ENABLE
    • CAPTURE_AUTO_EXPORT_LOCATION
    • CAPTURE_AUTO_EXPORT_USERNAME
    • CAPTURE_AUTO_EXPORT_PASSWORD
    • SHARED_CONSOLE_ENABLE
    • SHARED_CONSOLE_PORT
    Added locfg.pl command line options "-u username" and "-p password".
  • Note: Use "-u" and "-p" with caution as comamnd line options are visible on Linux.

  • Version:2.10.0-1 (12 Jul 2006)
    Fixes

    Upgrade Requirement:
    Recommended - HPE recommends users update to this version at their earliest convenience.


    Fixed tag names for ILO 2 in Mod_VLAN.xml.

    Enhancements

    New support for iLO 2 v1.1x and v1.20.

    Added following sample scripts:

    • Copy_Virtual_Floppy.xml
    • Get_All_Cables_Status.xml
    • Get_EmHealth.xml
    • Get_Host_APO.xml
    • Get_Power_Readings.xml
    • Get_VPB_Cable_Status.xml
    • Set_Host_APO.xml

    Version:2.00.0-1 (2 Feb 2006)
    Fixes

    Upgrade Requirement:
    Recommended - HPE recommends users update to this version at their earliest convenience.


    Added sample script for set_host_power
    Updated get_ilo_log to not use RIB info mode write Fixes typos in scripts.

    Enhancements

    New support for iLO 2 v1.0x and RILOE-II v1.20.


    Version:1.80.0-1 (14 Jul 2005)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    The following scripts have been added or modified to support additional firmware features available in 1.80:

    Mod_VLAN.xml
    Mod_Schemaless_Directory.xml
    Get_Host_Pwr_Reg_Info.xml
    Mod_2Factor.xml
    Import_2Factor_Certs.xml
    Get_2Factor.xml


    Version:1.70.0-1 (13 Apr 2005)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    The following scripts have been added or modified to support additional firmware features available in 1.70:
    NEW SAMPLE SCRIPTS
    Get_Host_Power_Saver.xml
    Set_Host_Power_Saver.xml


    Version:1.64.0-1 (24 Nov 2004)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    The following scripts have been added or modified to support additional firmware features available in 1.64:

    • Cert_Request.xml

    • Import_Cert.xml

    Version:1.60 (16 Jul 2004)
    Enhancements

    Upgrade Requirement:
    Optional - Users should update to this version if their system is affected by one of the documented fixes or if there is a desire to utilize any of the enhanced functionality provided by this version.


    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.


    Version:1.5 (23 Jan 2004)
    Enhancements
    Updated with new iLO v1.50 scripting commands.

    Legal Disclaimer: Products sold prior to the November 1, 2015 separation of Hewlett-Packard Company into Hewlett Packard Enterprise Company and HP Inc. may have older product names and model numbers that differ from current models.