Redfish API Support#

The BMC Module of the NVIDIA IGX Developer Kit supports the Redfish APIs in this documentation. DMTF’s Redfish is a standard set of APIs for managing and monitoring a platform.

Use this documentation to perform the following tasks:

Log in to your BMC#

To log into your BMC, do the following steps. After you complete these steps you can use the environment variables $bmc and $token in other procedures in this documentation.

  1. Save the IP address of your BMC as an environment variable by running the following code. Replace <BMC_IP> with your IP address, for example 192.168.1.110.

    export bmc=<BMC_IP>
    
  2. Log into your BMC and save your access token as an environment variable by running the following code. Change <BMC_Password> to your password.

    export token=`curl -k \
                       -H "Content-Type: application/json" \
                       -X POST https://$bmc/login \
                       -d '{"username": "root", "password": "<BMC_Password>"}' | grep token | awk '{print $2;}' | tr -d '"'`
    

Get your BMC firmware version#

To get your BMC firmware version, after you log in to your BMC, run the following code.

curl -k \
     -H "X-Auth-Token: $token" \
     -X GET https://$bmc/redfish/v1/UpdateService/FirmwareInventory/BMC_Firmware

— or —

curl -k \
     -H "X-Auth-Token: $token" \
     -X GET https://$bmc/redfish/v1/Managers/IGX_BMC_0

Reboot your BMC#

To reboot your BMC, after you log in to your BMC, run the following code.

curl -k \
     -H "X-Auth-Token: $token" \
     -X POST https://$bmc/redfish/v1/Managers/IGX_BMC_0/Actions/Manager.Reset \
     -d '{"ResetType": "GracefulRestart"}'

Mount the Base OS iso file#

To mount the Base OS iso file over https for BMC installation, after you log in to your BMC, run the following code.

curl -k \
     -H Content-Type:application/json -H "X-Auth-Token:$token" \
     -X POST https://${bmc}/redfish/v1/Managers/IGX_BMC_0/VirtualMedia/USB1/Actions/VirtualMedia.InsertMedia \
     -d '{"Image":"smb://<Ubuntu Desktop IP>/sambashare/<BaseOS filename>","WriteProtected":true,"UserName":"<SAMBA USERNAME>","Password":"<SAMBA PASSWORD>","Inserted":true,"TransferMethod":"Stream","TransferProtocolType":"CIFS"}'

Reset your BMC and settings#

To reset your BMC and settings to the factory default, after you log in to your BMC, run the following code.

curl -k \
     -H "X-Auth-Token:$token" \
     -X POST https://$bmc/redfish/v1/Managers/IGX_BMC_0/Actions/Manager.ResetToDefaults \
     -d '{"ResetToDefaultsType": "ResetAll"}'