Scale-Up Fabric
Configure and inspect the scale-up fabric manager on switches.
For definitions of execution modes and job polling, refer to Async jobs.
ConfigureScaleUpFabricManager
rack_manager.RackManager/ConfigureScaleUpFabricManager
ConfigureScaleUpFabricManager performs complete ScaleUpFabricManager configuration on a switch. This includes enabling the scale fabric services services,configuring gRPC access,and sets multi-node scaleup topology based on the hardware platform. Credentials are resolved from the node’s stored inventory data.
This is the single-switch version. For declarative configuration of a whole fabric, use RackManagerV2/ConfigureScaleUpFabricManager.
Request: ConfigureScaleUpFabricManagerRequest
Response: ConfigureScaleUpFabricManagerResponse
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.
GetScaleUpFabricStatus
rack_manager.RackManager/GetScaleUpFabricStatus
GetScaleUpFabricStatus synchronously inspects the fabric without changing anything and returns the observed scale-up configuration: per-switch state, topology, and static configuration reported by the fabric manager. This read is not associated with a reconciliation job.
Request: GetScaleUpFabricStatusRequest
Response: GetScaleUpFabricStatusResponse
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.
InspectScaleUpFabrics
rack_manager.RackManager/InspectScaleUpFabrics
InspectScaleUpFabrics discovers enabled controllers and reports their live compute and switch members, control-plane state, and sampled component status. Compute BMCs provide physical identities for correlating observed GPUs with caller node IDs; compute hosts are not configured or tested. No devices are changed. Results do not verify a desired configuration, end-to-end communication, or bandwidth.
This server returns UNIMPLEMENTED for live multi-fabric inspection.
Request: InspectScaleUpFabricsRequest
Response: InspectScaleUpFabricsResponse
Errors: Refer to Conventions for how RMS reports failures. This RPC also returns these gRPC errors:
UNIMPLEMENTED: Live multi-fabric inspection is not implemented by this server.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.
BatchResetSwitchSdnFactoryDefault
rack_manager.RackManager/BatchResetSwitchSdnFactoryDefault
BatchResetSwitchSdnFactoryDefault submits asynchronous SDN factory-default resets. All switches in the request use the same domain for switch mTLS material. Returns a parent job ID. Use GetJobStatus with child job states to track per-node progress. The reset is idempotent; callers can retry after transport or service failure. Note: post hard reset, the scale-up fabric must be reconfigured.
This operation is destructive. After a reset, reconfigure the scale-up fabric.
Request: BatchResetSwitchSdnFactoryDefaultRequest
Response: BatchResetSwitchSdnFactoryDefaultResponse
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.
BatchSetScaleUpFabricState
rack_manager.RackManager/BatchSetScaleUpFabricState
BatchSetScaleUpFabricState synchronously sets ScaleUpFabric state and saves config across all supplied switches.
Request: BatchSetScaleUpFabricStateRequest
Response: BatchSetScaleUpFabricStateResponse
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.
BatchGetScaleUpFabricServiceStatus
rack_manager.RackManager/BatchGetScaleUpFabricServiceStatus
BatchGetScaleUpFabricServiceStatus retrieves cluster health and fabric-manager status for a caller-supplied list of switches using switch Rest APIs.
Request: BatchGetScaleUpFabricServiceStatusRequest
Response: BatchGetScaleUpFabricServiceStatusResponse
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.
GetScaleUpFabricState
rack_manager.RackManager/GetScaleUpFabricState
GetScaleUpFabricState retrieves the cluster state for a caller-supplied switch using switch APIs.
Request: GetScaleUpFabricStateRequest
Response: GetScaleUpFabricStateResponse
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.
SetScaleUpFabricTelemetryInterfaceState
rack_manager.RackManager/SetScaleUpFabricTelemetryInterfaceState
SetScaleUpFabricTelemetryInterfaceState enables or disables the FabricTelemetryInterface service. FabricTelemetryInterface provides streaming telemetry and configuration management capabilities.
Request: SetScaleUpFabricTelemetryInterfaceStateRequest
Response: SetScaleUpFabricTelemetryInterfaceStateResponse
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.
ConfigureScaleUpFabricManager (V2)
rack_manager_v2.RackManagerV2/ConfigureScaleUpFabricManager
ConfigureScaleUpFabricManager declaratively configures the scale-up fabric across all supplied switches. The caller describes the desired fabric configuration and RMS starts a single asynchronous reconciliation job that performs only the actions required to move the observed switch state toward the desired state: it skips disabling the fabric when it is already disabled, and does nothing when the observed configuration matches the request and controller activation is verified.
The call is safe to invoke periodically in a loop to keep switch configuration “as intended” without causing fabric availability issues. RMS aims to run one reconciliation job at a time; callers should poll GetJobStatus before resubmitting and avoid issuing concurrent ConfigureScaleUpFabricManager requests.
Without layout, requests with an empty topology_type or otherwise invalid config are rejected synchronously with INVALID_ARGUMENT; no job is started.
Returns a job_id; poll it via rack_manager.GetJobStatus. Without layout, successful jobs return JSON-encoded rack_manager.ScaleUpFabricStatus in rack_manager.JobStatus.result_json.
With layout, the resulting configuration contains one cluster and primary per fabric, with administrative switch connectivity matching the requested layout. Submit the complete desired fabric set in one request because the fabrics share switch connectivity settings. GetJobStatus reports execution state and errors. InspectScaleUpFabrics reports current fabric members and sampled component status, including partial configurations after a failed job. Completion requires verified administrative switch settings and configured fabric-manager control planes, not compute software or operational GPU links.
Layout requests require matching deployment rules and the complete physical switch inventory. Without layout, RMS validates every node ID and type, then configures only switches.
Request: ConfigureScaleUpFabricManagerRequest
Response: ConfigureScaleUpFabricManagerResponse
Errors: Refer to Conventions for how RMS reports failures. This RPC also returns these gRPC errors:
INVALID_ARGUMENT: The topology, inventory, or layout request is invalid. No job starts.FAILED_PRECONDITION: Physical discovery, deployment planning, or switch ownership prevents admission. No configuration worker starts.INTERNAL: Job admission or coordinator state fails internally. No configuration worker starts.UNIMPLEMENTED: Layout configuration has no installed deployment catalog or the switch family is unsupported. No job starts.
Example request
Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.