Drivers & software

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

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

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

Installation:
Unzip/Untar linux-LOsamplescripts4.50.0.tgz to a subdirectory. This file contains the following scripts:

• Add_Federation_Group.xml – Add an iLO Federation Management group membership and grant associated privileges.
• 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_AHS_Data.xml - This is a sample XML script to clear 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
• Computer_Lock_Config.xml - Change the values for Computer Lock settings.
• Delete_Federation_Group.xml – Delete an iLO Federation Management group membership.
• Delete_SSH_Key.xml - deletes existing SSH key.
• 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.
• ERS_DC_CompleteRegistration.xml - Complete step 2 in the Insight Remote Support Direct Connect registration process.
• ERS_DC_RegisterDevice.xml - Complete step 1 in the Insight Remote Support Direct Connect Registration process.
• Factory_Defaults.xml - Set the Lights-Out device to factory default settings.
• Get_2Factor.xml - Obtain the two factor authentication configuration 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_Boot_Mode.xml – Get the server’s pending boot mode.
• Get_Cert_Subject.xml - Retrieve iLO2 certificate subject information.
• Get_Current_Boot_Mode.xml – Get the server’s current boot mode.
• Get_Diagport.xml - Return BL p-class diagport settings.
• Get_Directory.xml - Return the current directory configuration of an Lights-Out device.
• Get_Embedded_Health.xml - Return the current embedded health status.
• 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_Federation_All_Groups.xml – View the iLO Federation Management group memberships for a server
• Get_Federation_All_Groups_Info.xml – Get a list of all iLO Federation Management group memberships and granted privileges
• Set_Federation_Multicast_Options.xml – Set the iLO Federation Management multicast options for a server.
• 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_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_Host_Pwr_Reg_Info.xml - Obtain the power regulator state information for supported platforms.
• Get_Hotkey_Config.xml - Retreive 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_Network.xml - Return network settings.
• Get_language.xml - This is a sample XML script to get the default language setting and to retrieve the list of installed languages.
• Get_Network.xml - Return network settings.
• Get_One_Time_Boot_Order.xml - To retrieve the current State of the One Time Boot.
• Get_Permouse_Status.xml - Return the status of the Persistent Mouse and Mouse setting.
• Get_Persistent_Boot_Order.xml - To retrieve the current State of the Boot Order.
• Get_Power_On_Time.xml – To retrieve the Power On time status.
• Get_Power_Readings.xml: Return the power readings from the server.
• Get_PowerCap.xml - Return Power Cap setting.
• Get_Product_Name.xml - Return the Product Name of server.
• Get_Pwreg_Alert_Threshold.xml – To retrieve the Power Regulator Alert Threshold settings.
• Get_Rack_Settings.xml - To return enclosure data for c-Class blade infrastructure.
• Get_SDCard_Status.xml - To know whether there is an SD card connected to the server.
• Get_Security_Msg.xml - To retrieve the current security text message set in the iLO Login Banner.
• Get_Server_FQDN.xml - To get the host server Fully Qualified Domain Name.
• 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_Supported_Boot_Mode.xml - View the server boot mode.
• Get_Topology.xml - Return BL p-Class rack infrastructure topology.
• Get_TPM_Status.xml – View the status of the Trusted Platform Module (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.
• Hotkey_Config.xml - Change the values for Remote Console hotkeys.
• 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.
• 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_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.
• locfg.pl - Sample PERL script to send XML commands.
• Lock_Configuration.xml - To configure OS Lock settings.
• Mod_2Factor.xml - Configure two-factor authentication settings.
• Mod_Blade_Rack.xml - Change the BL p-Class blade and rack settings.
• Mod_ConsoleCapture_Port_Settings.xml - This is a sample XML script to disable or enable console capture port for iLO 2.
• 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_Federation_Group.xml – Modify iLO Federation Management 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 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.
• Mod_VM_Port_Settings.xml - This is a sample XML script to disable or enable virtual media for iLO 2.
• Mod_VSP_Flow_Control.xml - Configure the VSP Flow control Settings.
• Profile_Apply.xml - To 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_Download.xml - To write a Profile Description, download a specific blob and write the blob to the blob store.
• Profile_Desc_List.xml - 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.
• Send_Snmp_Test_Trap.xml - To send a test SNMP trap to the alert destinations configured for the iLO.
• Set_AHS_Status.xml - This is a sample XML script to enable or disable AHS logging.
• Set_Boot_Mode.xml – Set the server’s pending boot mode.
• Set_Brownout.xml - This is a sample XML script to enable or disable brownout support.
• Set_CSR_Custom.xml - Set certificate signing request settings with custom subject info.
• Set_CSR_Default.xml - Set certificate signing request settings to default subject info.
• Set_FIPS_Enable.xml - This is a sample XML script to enable FIPS mode.
• Set_Fqdn.xml - To change the iLO SSL self signed certificate FQDN selection.
• Set_Host_APO.xml - Change server automatic power on and power on delay settings.
• 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 - To Set One Time Boot Order.
• Set_Permouse_Status - Change the Persistent Mouse and Keyboard setting.
• Set_Persistent_Boot_Order.xml – Set the server’s persistent boot mode.
• Set_PowerCap.xml - Change the Power Cap setting.
• Set_Pwreg_Alert_Threshold.xml
• Set_Security_Msg.xml - To configure the current security text message set in the iLO Login Banner.
• Set_Server_FQDN.xml - This is a sample XML script to set the host server Fully Qualified Domain Name.
• Set_Server_Name.xml: Set the host server name.
• Set_Virtual_Power_BTN.xml - To execute cold boot and warm boot of the server and to simulate a physical press of the server power button.
• 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.
• Update_Language.xml - Updates the iLO Language Pack.
• vspconfig.pl - Set the Virtual Serial Port Configuration for Linux.
• linux-LOsamplescripts4.50.0.txt - README file.

A valid iLO user account and password is required for each XML script when using LOCFG.PL. The user account must have appropriate lights-out privileges to process the request.

The locfg.pl script connects to the iLO management processor using a Secure Sockets Layer (SSL) connection where:
perl locfg.pl -s {servername|ipaddress}[:port] [-l logfilename] -f input_filename [-u username -p password] [-ilo2|-ilo3|-ilo4]

• -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|ilo4 - Specifies the type of device on the server.  Note: locfg.pl detects the device automatically if this option is not present.

End User License Agreements:
Hewlett-Packard End User License Agreement

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:
HP Integrated Lights-Out 4 User Guide, HP Integrated Lights-Out 3 User Guide, HP Integrated Lights-Out 2 User Guide, HP Integrated Lights-Out User Guide, and HP Integrated Lights-Out 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.

See "HP Integrated Lights-Out Management Processor Scripting and Command Line Resource Guide" for more information on scripting and the syntax of the RIBCL XML.