Printable version

Drivers & software

RESTful Interface Tool for Linux

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: Utility - Tools
Version: 3.1.1(12 Nov 2020)
Operating System(s): Red Hat Enterprise Linux 5 Server (x86-64)
Red Hat Enterprise Linux 6 Server (x86-64)
Red Hat Enterprise Linux 7 Server
Red Hat Enterprise Linux 8 Server
SUSE Linux Enterprise Server 11 (AMD64/EM64T)
SUSE Linux Enterprise Server 12
SUSE Linux Enterprise Server 15
File name: ilorest-3.1.1-11.x86_64.rpm (8.6 MB)
Command line tool for Linux for interacting with iLO RESTful interface

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

75cba0c6da37b3a45da226b43f8b1d60cba3408121b0a65955e2295820152ca8 RPMS/x86_64/ilorest-3.1.1-11.x86_64.rpm

Reboot Requirement:
Reboot is optional after installation. Updates will be effective after reboot. Hardware stability will be maintained without reboot.

Installation:

Verify the RPM signature using the following steps:

Download the HPE GPG 2048-bit Public Key (hpePublicKey2048_key1.pub), which is available from the HPE SDR web site: https://downloads.linux.hpe.com/keys.html

Import the public key while logged in as root by running the following command:

   # rpm --import /path_to_the_key/file_name_of_the_key

   example # rpm --import /path_to_the_key/26C2B797.pub

 

Verify the RPM:

Use the rpm --checksig command to validate and verify the digital signature of the signed file. The output from the command indicates the validity of the signature:

   # rpm --checksig filename_of_the_rpm

   example result #  rpm --checksig <File name>.rpm

  <File name>.rpm: digests signatures OK

If your file does not pass verification or you do not have the Hewlett Packard Enterprise Company public key installed, you may see an error:

   # rpm --checksig sample_file.rpm

   sample_file.rpm: (SHA1) DSA sha1 md5 (GPG) NOT OK (MISSING KEYS: key#s)

In this case then do not install the rpm. This means the file has been modified in some way since being released from Hewlett Packard Enterprise Company

Run the RPM:

Login as the system administrator (root), download the RPM to a directory on your hard drive and change to that directory.

To install the package, type:

  • rpm -ivh <packagename>.rpm

After installation, the ilorest command is now available to use.

 

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.

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.

For fixes, refer Change log.

Version:3.1.1 (12 Nov 2020)
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.

For fixes, refer Change log.

Version:3.1.0 (5 Oct 2020)
Fixes

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

  • ServerClone Updates/Fixes
  • Update to new raw file format {path: body}
  • Added ability to create custom roles with the directory command
  • Addressed RESTful Interface Tool timeout issue during UBM1 Firmware flash
  • Fixed LDAP Kerberos authentication enable/disable issue

Version:3.0.1 (29 Jan 2020)
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.

  • Fixed serverclone SSA usage.
  • Fixed serverclone benign error appearing when performing a load.

Version:3.0.0 (20 Dec 2019)
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 for SSL certificate verification
  • Added support in the iloaccount command to add and remove user certificates
  • Added Tab complete support in interactive mode to read schema data of properties
  • Updated ilofederation command to match iloaccounts

Version:2.5.1 (23 Sep 2019)
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.

  • Fixed error validating system unique properties when using load command and Bios. selector.
  • Fixed some issues patching certain properties in serverclone.

Version:2.5.0 (5 Jul 2019)
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.

  • Added Persistent Memory Commands
  • Added the ability to select controllers by Slot in Smart Array commands.

Version:2.4.1 (4 Apr 2019)
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 Commands
    • serverclone: Used for saving and loading iLO, Bios, and Smart Array configurations. Can be used to save from one system and load it to many or for backups.
    • backuprestore: Saves and loads a backup iLO config file. Can only load a file from the same system that the file came from.
    • onebuttonerase: Performs and monitors the One Button Erase process for server re-purpose and decommission.
    • directory: Configures and shows LDAP and Kerberos directory settings for iLO as well as performs tests for directory connection.
  • New options
    • Save command option, --multisave, allows you to save more than one type to a single file.
  • Other important changes
    • The tool no longer force logs you out after committing. This will allow you to continue making changes on the same session.

Version:2.3.4 (31 Oct 2018)
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.

  • Fixed an issue with local AHS downloads.
Enhancements

  • Added command to guide users through creation of an install set.
  • Added maintenance window command.
  • Added new options for invoking install sets.

Version:2.3.3 (23 Oct 2018)
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.

  • Fixed an issue with the flashfwpkg command.
Enhancements

  • Added command to guide users through creation of an install set.
  • Added maintenance window command.
  • Added new options for invoking install sets.

Version:2.3.1 (2 Jul 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 command to guide users through creation of an install set.
  • Added maintenance window command.
  • Added new options for invoking install sets.

Version:2.2.2 (16 Feb 2018)
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.

Resolves issue in RESTful Interface Tool version 2.20 which prevented usage of the --biospassword flag.

Version:2.2 (5 Feb 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 support for local iLO High Security mode.

Added ipprofiles command.

Added FIPS mode.

Version:2.1 (12 Oct 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 NVDIMM commands.

Version:2.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.

Adding support for iLO 5.

Version:1.5.1 (25 Jan 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 “Enforce AES/3DES Encryption” mode.

Version:1.5 (10 May 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.

Fixes and enhancements can be found in the release notes located here: http://www.hpe.com/support/restful_tool_rn_en

Version:1.4 (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.

Fixes and enhancements can be found in the release notes located here: www.hpe.com/support/restful_tool_rn_en

Version:1.3 (27 Aug 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.

Fixes and enhancements can be found in the release notes located here: www.hp.com/support/restful_tool_rn_en

Version:1.2 (26 Jun 2015)
Fixes

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

Fixes and enhancements can be found in the release notes located here: www.hp.com/support/restful_tool_rn_en

Version:1.1 (1 Apr 2015)
Enhancements

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

Added support for the following Gen9 Servers:

  • HP ProLiant ML110 Gen9 Server
  • HP Apollo 2000 Server
  • HP ProLiant WS460c Gen9 Server

Version:1.0 (30 Oct 2014)
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.

Initial version.

Type: Utility - Tools
Version: 3.1.1(12 Nov 2020)
Operating System(s):
Red Hat Enterprise Linux 5 Server (x86-64)
Red Hat Enterprise Linux 6 Server (x86-64)
Red Hat Enterprise Linux 7 Server
Red Hat Enterprise Linux 8 Server
SUSE Linux Enterprise Server 11 (AMD64/EM64T)
SUSE Linux Enterprise Server 12
SUSE Linux Enterprise Server 15

Description

Command line tool for Linux for interacting with iLO RESTful interface

Installation Instructions

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

75cba0c6da37b3a45da226b43f8b1d60cba3408121b0a65955e2295820152ca8 RPMS/x86_64/ilorest-3.1.1-11.x86_64.rpm

Reboot Requirement:
Reboot is optional after installation. Updates will be effective after reboot. Hardware stability will be maintained without reboot.

Installation:

Verify the RPM signature using the following steps:

Download the HPE GPG 2048-bit Public Key (hpePublicKey2048_key1.pub), which is available from the HPE SDR web site: https://downloads.linux.hpe.com/keys.html

Import the public key while logged in as root by running the following command:

   # rpm --import /path_to_the_key/file_name_of_the_key

   example # rpm --import /path_to_the_key/26C2B797.pub

 

Verify the RPM:

Use the rpm --checksig command to validate and verify the digital signature of the signed file. The output from the command indicates the validity of the signature:

   # rpm --checksig filename_of_the_rpm

   example result #  rpm --checksig <File name>.rpm

  <File name>.rpm: digests signatures OK

If your file does not pass verification or you do not have the Hewlett Packard Enterprise Company public key installed, you may see an error:

   # rpm --checksig sample_file.rpm

   sample_file.rpm: (SHA1) DSA sha1 md5 (GPG) NOT OK (MISSING KEYS: key#s)

In this case then do not install the rpm. This means the file has been modified in some way since being released from Hewlett Packard Enterprise Company

Run the RPM:

Login as the system administrator (root), download the RPM to a directory on your hard drive and change to that directory.

To install the package, type:

  • rpm -ivh <packagename>.rpm

After installation, the ilorest command is now available to use.

 

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.

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.

For fixes, refer Change log.

Revision History

Version:3.1.1 (12 Nov 2020)
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.

For fixes, refer Change log.

Version:3.1.0 (5 Oct 2020)
Fixes

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

  • ServerClone Updates/Fixes
  • Update to new raw file format {path: body}
  • Added ability to create custom roles with the directory command
  • Addressed RESTful Interface Tool timeout issue during UBM1 Firmware flash
  • Fixed LDAP Kerberos authentication enable/disable issue

Version:3.0.1 (29 Jan 2020)
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.

  • Fixed serverclone SSA usage.
  • Fixed serverclone benign error appearing when performing a load.

Version:3.0.0 (20 Dec 2019)
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 for SSL certificate verification
  • Added support in the iloaccount command to add and remove user certificates
  • Added Tab complete support in interactive mode to read schema data of properties
  • Updated ilofederation command to match iloaccounts

Version:2.5.1 (23 Sep 2019)
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.

  • Fixed error validating system unique properties when using load command and Bios. selector.
  • Fixed some issues patching certain properties in serverclone.

Version:2.5.0 (5 Jul 2019)
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.

  • Added Persistent Memory Commands
  • Added the ability to select controllers by Slot in Smart Array commands.

Version:2.4.1 (4 Apr 2019)
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 Commands
    • serverclone: Used for saving and loading iLO, Bios, and Smart Array configurations. Can be used to save from one system and load it to many or for backups.
    • backuprestore: Saves and loads a backup iLO config file. Can only load a file from the same system that the file came from.
    • onebuttonerase: Performs and monitors the One Button Erase process for server re-purpose and decommission.
    • directory: Configures and shows LDAP and Kerberos directory settings for iLO as well as performs tests for directory connection.
  • New options
    • Save command option, --multisave, allows you to save more than one type to a single file.
  • Other important changes
    • The tool no longer force logs you out after committing. This will allow you to continue making changes on the same session.

Version:2.3.4 (31 Oct 2018)
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.

  • Fixed an issue with local AHS downloads.
Enhancements

  • Added command to guide users through creation of an install set.
  • Added maintenance window command.
  • Added new options for invoking install sets.

Version:2.3.3 (23 Oct 2018)
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.

  • Fixed an issue with the flashfwpkg command.
Enhancements

  • Added command to guide users through creation of an install set.
  • Added maintenance window command.
  • Added new options for invoking install sets.

Version:2.3.1 (2 Jul 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 command to guide users through creation of an install set.
  • Added maintenance window command.
  • Added new options for invoking install sets.

Version:2.2.2 (16 Feb 2018)
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.

Resolves issue in RESTful Interface Tool version 2.20 which prevented usage of the --biospassword flag.

Version:2.2 (5 Feb 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 support for local iLO High Security mode.

Added ipprofiles command.

Added FIPS mode.

Version:2.1 (12 Oct 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 NVDIMM commands.

Version:2.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.

Adding support for iLO 5.

Version:1.5.1 (25 Jan 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 “Enforce AES/3DES Encryption” mode.

Version:1.5 (10 May 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.

Fixes and enhancements can be found in the release notes located here: http://www.hpe.com/support/restful_tool_rn_en

Version:1.4 (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.

Fixes and enhancements can be found in the release notes located here: www.hpe.com/support/restful_tool_rn_en

Version:1.3 (27 Aug 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.

Fixes and enhancements can be found in the release notes located here: www.hp.com/support/restful_tool_rn_en

Version:1.2 (26 Jun 2015)
Fixes

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

Fixes and enhancements can be found in the release notes located here: www.hp.com/support/restful_tool_rn_en

Version:1.1 (1 Apr 2015)
Enhancements

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

Added support for the following Gen9 Servers:

  • HP ProLiant ML110 Gen9 Server
  • HP Apollo 2000 Server
  • HP ProLiant WS460c Gen9 Server

Version:1.0 (30 Oct 2014)
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.

Initial version.

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.