Step 1: Upload the Local Firmware Package File

Use a POST request to upload a local firmware package file.

Note:

Firmware packages can take several minutes to upload depending on network speed.

HTTP Request Format:

POST /rest/v<version>/SP/firmware/update HTTP/1.1
<Header Name>: <value>

<Request body>

Where:

• The <Request body> contains the package file contents in a multi-part data form format.

Request Headers Required:

The following request headers are required to upload a local firmware package file.

• Accept header – The Accept: header must specify the value of application/json or a superset of application/json.

• Content-Type header – The Content-Type: header must specify the value of multipart/form-data.

  Note:

  Some tools such as cURL provide the Content-Type and file contents when the user supplies the file path.

• Other headers– Authenication and Host headers are required. For a description of these headers, see Common Request Header Fields.

Response: Status Codes

• Success: HTTP Status = 200 OK

• Failure: HTTP Status = 4xx, 5xx

Response Body:

Note:

To identify the exact response body media type, refer to the Oracle ILOM Swagger Model (swagger.json) description. For more details, see Discovering Management Resources.

{
  "Target":"/rest/v<version>/SP/firmware/update/1",
  "Targets":[
    {
      "name":"questions",
      "uri":"/rest/v1/SP/firmware/update/1/questions"
    },
    {
      "name":"status",
      "uri":"/rest/v1/SP/firmware/update/1/status"
    },
    {
      "name":"versions",
      "uri":"/rest/v1/SP/firmware/update/1/versions"
    }
  ]
}

Where:

• The context number /1 represents the first local firmware package uploaded to the server SP. For every new firmware package created on the server SP, the content number that the REST API assigns is incremented by one. For example, 1 is assigned to the first package created. If the first package is later removed and another package is created, the second package instance is then assigned 2.

  Note:

  As of Oracle ILOM firmware version 5.0, only one firmware update image can be up uploaded to the server SP at a given time. Earlier versions of Oracle ILOM firmware versions (4.0.1 and later 4.x.releases), supported up to three active firmware update instances at a given time.

• The "questions" are the same firmware update questions that are asked when using the Oracle ILOM CLI to perform the update. All answers to these questions must be answered either true or false. For information on how to view and provide answers to these questions, see Step 2: View and Answer the Firmware Configuration Questions.