Go to main content

Oracle® ILOM Web Service REST API

Exit Print View

Updated: December 2019
 
 

Downloading Host Console History

To extract the entire console history to a binary (non-text) file using the Oracle ILOM REST API, see one of the following topics


Note -  The ability to download the console history is not supported on multi-domain platforms such as SPARC M-Series servers.

Using a PATCH Request to Download Host Console History (Prior to firmware version 5.0)

The Oracle ILOM REST API, prior to firmware version 5.0, support the ability to use a PATCH request to extract the entire console history to a binary (non-text) file.

HTTP Request Format: PATCH

PATCH /rest/v<version>/HOST/console/history
<Header Name>: <value>

{
"dump": true
}

Where:

  • "dump":true initiates the extraction process of the host console history data.

Request Headers Required

The request header fields required to modify resources are as follows: Content-Type, Accept, Authorization, and Host.


Note -  The request Accept header must specify application/octet-steam as the target media type. The Content-Type request header must specify application/json as the target media type.

For a description of these required header fields, see Common Request Header Fields.

cURL Example

Using cURL, a request to extract the host console history to a binary (non-text) file (console_History.log) would look like this:

curl -k --request PATCH -u "root:changeme" -H "Content-Type:application/json" 
--data '{"dump":true}' https://<IPaddress>:443/rest/v1/HOST/console/history > console_history.log

Using a GET Request to Download Host Console History (As of firmware version 5.0 and later)

The Oracle ILOM REST API, as of firmware version 5.0, supports the ability to use a GET request to extract the entire console history to a binary (non-text) file.

HTTP Request Format:

GET /rest/v<version>/HOST/console/history HTTP/1.1
<Header Name>: <value>

Request Headers Required

The request header fields required to retrieve resources are as follows: Accept, Authorization, and Host.


Note -  The request Accept header must specify application/octet-steam as the target media type.

For a description of these required header fields, see Common Request Header Fields.

cURL Request Example

Using cURL, a request to extract the host console history to a binary (non-text) file (console_history.log) would look like this:

curl -k --request GET -u "root:changeme" https://<IPaddress>:443/rest/v1/HOST/console/history/content >
console_history.log