Firmware Updates
Start firmware updates on one node, many nodes, or from a firmware object.
For definitions of execution modes and job polling, refer to Async jobs.
UpdateFirmware
rack_manager.RackManager/UpdateFirmware
UpdateFirmware initiates a firmware update on a specific node asynchronously. Returns a job ID immediately. Use GetFirmwareJobStatus to track progress. Works for all node types (compute, powershelf, switch).
Request: UpdateFirmwareRequest
Response: UpdateFirmwareResponse
Errors: Refer to Conventions for how RMS reports failures.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.
The rack_manager_client test client offers an equivalent command:
BatchUpdateFirmwareByNodeType
rack_manager.RackManager/BatchUpdateFirmwareByNodeType
BatchUpdateFirmwareByNodeType initiates firmware updates on all nodes of a specific type in a rack asynchronously. Returns a parent job ID for tracking overall batch status, along with individual node job IDs. Use GetFirmwareJobStatus to track progress.
Request: BatchUpdateFirmwareByNodeTypeRequest
Response: BatchUpdateFirmwareByNodeTypeResponse
Errors: Refer to Conventions for how RMS reports failures.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.
The rack_manager_client test client offers an equivalent command:
BatchUpdateFirmware
rack_manager.RackManager/BatchUpdateFirmware
BatchUpdateFirmware initiates firmware updates on a specified list of nodes asynchronously. Each node is identified by its NodeInfo. Separate firmware targets are provided for compute trays, switch trays, and power shelves, and the appropriate target is applied to each node based on its node type. Returns a parent job ID for tracking overall batch status, along with individual node job IDs. Use GetFirmwareJobStatus to track progress.
Request: BatchUpdateFirmwareRequest
Response: BatchUpdateFirmwareResponse
Errors: Refer to Conventions for how RMS reports failures.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.
The rack_manager_client test client offers an equivalent command:
ApplyStoredFirmwareObject
rack_manager.RackManager/ApplyStoredFirmwareObject
ApplyStoredFirmwareObject resolves stored firmware targets and starts firmware updates for supplied nodes.
Request: ApplyStoredFirmwareObjectRequest
Response: ApplyStoredFirmwareObjectResponse
Errors: Refer to Conventions for how RMS reports failures.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.
ApplyFirmwareObject
rack_manager.RackManager/ApplyFirmwareObject
ApplyFirmwareObject ingests a firmware object from JSON, downloads required artifacts, resolves firmware targets, and starts firmware updates for supplied nodes.
RMS treats the ingested firmware object as ephemeral for this request. It uses access_token only for artifact download and does not persist the token or object.
Request: ApplyFirmwareObjectRequest
Response: ApplyFirmwareObjectResponse
Errors: Refer to Conventions for how RMS reports failures.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.