Skip to content

Network protocols

NOTE

It is possible that some properties or resources described in this section are not implemented in iLO 4 and iLO 5.

This section provides information about the network protocols controlled by HPE iLO. The exhaustive list of iLO network protocols can be retrieved from the standard URI at /redfish/v1/Managers/1/NetworkProtocol.

Simple Network Management Protocol

HPE iLO supports the Simple Network Management Protocol (SNMP). SNMP traps are generated by Redfish events posted in the iLO Integrated Management Logs (IML). iLO SNMP Object Identifiers (OIDs) are defined in the HPE Systems Insight Manager (SIM) MIB update kit. To cross reference an SNMP trap with REST alerts information, see the REST alerts table in the iLO user guide.

TIP

If you make a mistake in the following iLOrest examples, you can always delete property changes in the cache, by reloading the a fresh schema/data-type (ilorest select Schema. --refresh ):

ilorest select Schema.
ilorest set Property="Bad Value"
ilorest select Schema. --refresh

SNMP enablement

SNMP enablement is performed by setting the SNMP/ProtocolEnabled property to true under the Redfish standard ManagerNetworkProtocol URI .

PATCH /redfish/v1/Managers/1/NetworkProtocol

SNMPv1 enablement

SNMPv1 is enabled when the SNMPv1Enabled key is set to true, under the /redfish/v1/Managers/1/SnmpService URI.

NOTE

An iLO reset is required when a PATCH request is performed on that property.

PATCH /redfish/v1/Managers/1/SnmpService

SNMP configuration

SNMPv3 configuration can only be performed when the SNMP is enabled. SNMPv1 configuration can only be performed when the SNMP and the SNMPv1 are enabled.

SNMP ports configuration

The SNMP default port number (161) can be modified with a PATCH request of the SNMP/Port property under the Redfish standard ManagerNetworkProtocol URI.

The SNMP default trap port (162) can be modified with a PATCH request of the OEM/Hpe/SNMPTrapPort property under the ManagerNetworkProtocol URI.

PATCH /redfish/v1/Managers/1/NetworkProtocol

SNMP settings

General SNMP settings can be set in under the HpeiLOSnmpService URI .

PATCH /redfish/v1/Managers/1/SnmpService
Warning

A space between the elements of the ReadCommunities array leads to the following error:

'[CommunityString1,' is not a valid setting for 'ReadCommunities', expecting an array

SNMPv3 settings

Specific SNMPv3 settings can be provided under the /redfish/v1/Managers/1/SnmpService URI .

PATCH /redfish/v1/Managers/1/SnmpService

SNMP alerts

SNMP alerts properties can be set under the /redfish/v1/Managers/1/SnmpService URI .

The following properties have been added in HpeiLOSnmpService version 2.4.0:

  • SNMPv1RequestsEnabled: Enables/disables (Boolean) iLO to receive external SNMPv1 requests.
  • SNMPv1TrapEnabled: Enables/disables (Boolean) iLO to send SNMPv1 traps to the remote management systems configured in the alert destination.
  • SNMPv3RequestsEnabled: Enables/disables (Boolean) iLO to receive external SNMPv3 requests.
  • SNMPv3TrapEnabled: Enables/disables (Boolean) iLO to send SNMPv3 traps to the remote management systems configured in the alert destination.
NOTE
  • SNMPv1Enabled enables both SNMPv1RequestsEnabled and SNMPv1TrapEnabled.
  • AlertsEnabled enables both SNMPv1TrapEnabled and SNMPv3TrapEnabled.
  • Enabling either SNMPv1RequestsEnabled or SNMPv1TrapEnabled enables SNMPv1Enabled.
  • Enabling either SNMPv1TrapEnabled or SNMPv3TrapEnabled enables AlertsEnabled.
PATCH /redfish/v1/Managers/1/SnmpService

SNMP alert destinations

Add an SNMP alert destination with a POST request in the HpeSNMPAlertDestinationCollection URI.

NOTE
  • The SNMPv1TrapEnabled option is available when SNMPv1TrapEnabled is enabled in the SNMP Alerts section.
  • The SNMPv3TrapEnabled option is available when SNMPv3TrapEnabled is enabled in the SNMP Alerts section and at least one SNMPv3 user is configured.
  • The SNMPv3Inform option is available when at least one SNMPv3 user is configured.
POST redfish/v1/Managers/1/SnmpService/SNMPAlertDestinations

SNMPv3 users

SNMPv3 users can be managed under the HpeSNMPUsersCollection URI .

NOTE

SNMPv3user is available only if the SNMP Protocol is set to SNMPv3TrapEnabled or SNMPv3Inform.

POST /redfish/v1/Managers/1/SnmpService/SNMPUsers

View the collection of SNMPv3 users:

GET /redfish/v1/Managers/1/SnmpService/SNMPUsers

View the properties of all SNMPv3 users:

GET /redfish/v1/Managers/1/SnmpService/SNMPUsers/?$expand=.

Delete SNMP user

DELETE /redfish/v1/Managers/1/SnmpService/SNMPUsers/2

Send test alerts

Test alerts can be sent to alert destinations using a POST request towards HpeiLOSnmpService.SendSNMPTestAlert under the /redfish/v1/Managers/1/SnmpService URI with an empty body.

POST /redfish/v1/Managers/1/SnmpService/Actions/HpeiLOSnmpService.SendSNMPTestAlert/

Intelligent Platform Management Interface

HPE iLO is able to control the use of the Intelligent Platform Management Interface ( IPMI) using the Redfish API.

The following example retrieves the state of IPMI using cURL and iLOrest.

GET /redfish/v1/Managers/1/NetworkProtocol/?$select=IPMI

Manage the KCS interface feature for HPE iLO

IPMI over Keyboard Controller Style (KCS) enables management of the computer system and monitoring of the operations from within the host Operating System (OS). It is possible to enable or disable KCS for iLO 6 since version 1.40.

The following example enables the KCS interface using iLOrest and cURL.

PATCH /redfish/v1/Managers/1/NetworkProtocol

Workload:
{ 
"Oem": {
    "Hpe":{
      "KcsEnabled": true
        }
      }
}

IPMI in-band management

In-band management operations can fail or be slow when the IPMI interrupt support is enabled in the HPE Bios service OEM extension of iLO 6 version 1.10 and later. Refer to this customer advisory for more detail.

The following example disables the KcsIpmiInterrupt attribute in the HPE Bios service subsystem of an HPE iLO 6 based server. Then it performs a graceful restart of the server.

PATCH /redfish/v1/Systems/1/Bios/Oem/Hpe/Service/Settings

Body:
{
    "Attributes": {
    "KcsIpmiInterrupt": "Disabled"
    }
}
TIP
  • More information concerning the HPE Bios service subsystem can be found in the Managing HPE Bios section.
  • After a modification in the BIOS settings (standard or OEM extension) and the restart of the server, it is a good practice to analyze the @Redfish.Settings object of the current settings area as explained in the Redfish error responses and messages section.
Previous page
Next page