Server Firmware Update Job

Overview

This job can be used to update the firmware on a server.

Note Firmware update is not supported on HPE Edgeline e920 server blades.

Job parameters marked with a * are required.

Create Job

A job can be created by issuing a POST to the /compute-ops-mgmt/v1/jobs endpoint with the correct payload for the job.

The following properties are used when creating a job:

If the job was created successfully, a 201 Created response is returned. The response includes the job resource which has a job resourceUri that you can use to track the progress of the job.

Job Parameters

This table summarizes the supported properties in jobParams.

Parameter properties

• bundle_id: This required property is the firmware bundle UUID that should be used for the firmware update.
  • The firmware bundle UUID can be obtained using GET /compute-ops-mgmt/v1/firmware-bundles and looking at the id property in the response.
• downgrade: This flag allows a downgrade of the firmware as part of the firmware update.
  • Default: false
• install_sw_drivers: This flag determines if HPE drivers and software should be installed in the OS as part of the firmware update.
  • Default: false
• power_off: This flag determines if server needs to be powered off after firmware update.
  • Default: false
• prerequisite_check: This flag determines whether the prerequisites are checked before a firmware update.
  • Default: true
  • If the prerequisites check passed without recommendations, the firmware update proceeds.
  • If the prerequisites check failed with recommendations, fix the reported issues to continue with the firmware update.
• skip_blocklisted_components: This flag determines whether to skip component updates that are blocked by known issues.
  • Default: false
• wait_for_power_off_or_reboot: This flag causes the update to wait for the user to reboot or power off the server before performing the installation.
  • Default: false
  • Note that the server reboot or power off must be performed outside of Compute Ops Management.
• wait_for_power_off_or_reboot_timeout: The amount of time in hours to wait for the server to reboot or power off, when the wait_for_power_off_or_reboot option is set to true.
  • Supported values are 1, 2, 4, 8, 12, 24
  • Default: 4

Example

Here's an example request payload for creating this job.

Example 1

Use the specified firmware bundle to update a server.

{
  "jobTemplate": "fd54a96c-cabc-42e3-aee3-374a2d009dba",
  "resourceType": "compute-ops-mgmt/server",
  "resourceId": "086856-F17+8899086856117487",
  "jobParams": {
    "bundle_id": "de600c7f01e29f793f26ad91b31d96ce"
  }
}

Example 2

Use the specified firmware bundle to update a server and power off the server after firmware update.

{
  "jobTemplate": "fd54a96c-cabc-42e3-aee3-374a2d009dba",
  "resourceType": "compute-ops-mgmt/server",
  "resourceId": "086856-F17+8899086856117487",
  "jobParams": {
    "bundle_id": "de600c7f01e29f793f26ad91b31d96ce",
    "power_off": true
  }
}

Example 3

Use the specified firmware bundle to update a server including HPE drivers and software.

{
  "jobTemplate": "fd54a96c-cabc-42e3-aee3-374a2d009dba",
  "resourceType": "compute-ops-mgmt/server",
  "resourceId": "086856-F17+8899086856117487",
  "jobParams": {
    "bundle_id": "de600c7f01e29f793f26ad91b31d96ce",
    "install_sw_drivers": true
  }
}

Example 4

Use the specified firmware bundle to update a server and allow to downgrade the firmware

{
  "jobTemplate": "fd54a96c-cabc-42e3-aee3-374a2d009dba",
  "resourceType": "compute-ops-mgmt/server",
  "resourceId": "086856-F17+8899086856117487",
  "jobParams": {
    "bundle_id": "de600c7f01e29f793f26ad91b31d96ce",
    "downgrade": true
  }
}

Example 5

Use the specified firmware bundle to update a server with prerequisite check.

{
  "jobTemplate": "fd54a96c-cabc-42e3-aee3-374a2d009dba",
  "resourceType": "compute-ops-mgmt/server",
  "resourceId": "086856-F17+8899086856117487",
  "jobParams": {
    "bundle_id": "de600c7f01e29f793f26ad91b31d96ce",
    "prerequisite_check": true
  }
}

Example 6

Use the specified firmware bundle to perform a server firmware update that skips components with known issues. The remaining components in the selected bundle are updated.

{
  "jobTemplate": "fd54a96c-cabc-42e3-aee3-374a2d009dba",
  "resourceType": "compute-ops-mgmt/server",
  "resourceId": "086856-F17+8899086856117487",
  "jobParams": {
    "bundle_id": "de600c7f01e29f793f26ad91b31d96ce",
    "skip_blocklisted_components": true
  }
}

Example 7

Use the specified firmware bundle to update a server after the user powers off or reboots the server within the specified time period.

{
  "jobTemplate": "fd54a96c-cabc-42e3-aee3-374a2d009dba",
  "resourceType": "compute-ops-mgmt/server",
  "resourceId": "086856-F17+8899086856117487",
  "jobParams": {
    "bundle_id": "de600c7f01e29f793f26ad91b31d96ce",
    "wait_for_power_off_or_reboot": true,
    "wait_for_power_off_or_reboot_timeout": 8
  }
}