Skip to navigation

System Validation

View as MarkdownOpen in Claude

Start NVSSVT system validation scans on nodes.

RPCExecutionSummary
StartSystemValidation (V2)Asynchronous, parent and child jobsStartSystemValidation launches an NVSSVT system validation scan against each Device Under Test (DUT) in the request, each as its own asynchronous RMS job.

For definitions of execution modes and job polling, refer to Async jobs.

StartSystemValidation (V2)

rack_manager_v2.RackManagerV2/StartSystemValidation

StartSystemValidation launches an NVSSVT system validation scan against each Device Under Test (DUT) in the request, each as its own asynchronous RMS job. NVSSVT itself may run for a long time, and each node’s scan runs independently: one node’s admission or launch failure does not affect any other node’s scan.

Returns a parent job_id (response.job_id); poll it via rack_manager.GetJobStatus to track the batch as a whole. Each admitted node’s own scan job_id is also returned in jobs, for polling and result retrieval scoped to that node. On completion, each scan job’s rack_manager.JobStatus.result_json holds its parsed per-DUT status and summary report JSON.

Each node’s scan runs as its own job. A failure to admit or launch one node does not affect the other nodes.

PropertyValue
ExecutionAsynchronous, parent and child jobs. The response returns a parent job ID and the work continues after the call returns.
Job trackingPoll GetJobStatus with the job ID in response.job_id. Per-node child job IDs are in jobs.
Job resultresult_json in the job status holds the parsed status and the summary report for that node’s scan.
TargetCaller-supplied nodes. The request carries each node’s endpoints and credentials, and RMS does not store them.
Behavior detailsOperations guide
Protobuf referenceStartSystemValidation

Request: StartSystemValidationRequest

FieldTypeDescription
nodesNodeSet-
config_overridestringPassed through to NVSSVT as —config-override for every node’s scan. Left unset, NVSSVT applies its own configuration defaults. RMS does not interpret or validate this value; NVSSVT rejects it if malformed.

Response: StartSystemValidationResponse

FieldTypeDescription
responseNodeBatchResponseresponse.job_id is the parent job ID for GetJobStatus
jobsrepeated NodeSystemValidationJobInfoIndividual scan job ID per node

Errors: Refer to Conventions for how RMS reports failures.

Replace each <placeholder> with a real value. Define RMS_GRPCURL_FLAGS and RMS_ADDR as described in Getting started.

grpcurl $RMS_GRPCURL_FLAGS \
-d '{
"nodes": {
"nodes": [
{
"node_id": "<node_id>",
"rack_id": "<rack_id>",
"type": "COMPUTE_GB200_NVIDIA",
"bmc_endpoint": {
"interface": {
"ip_address": "<ip_address>",
"mac_address": "<mac_address>",
"host_name": "<host_name>"
},
"port": 0,
"credentials": {
"user_pass": {
"username": "<username>",
"password": "<password>"
}
}
},
"host_endpoint": {
"interface": {
"ip_address": "<ip_address>",
"mac_address": "<mac_address>",
"host_name": "<host_name>"
},
"port": 0,
"credentials": {
"user_pass": {
"username": "<username>",
"password": "<password>"
}
}
},
"node_descriptor": {
"attributes": {
"<key>": "<attributes>"
}
},
"additional_host_endpoints": [
{
"interface": {
"ip_address": "<ip_address>",
"mac_address": "<mac_address>",
"host_name": "<host_name>"
},
"port": 0,
"credentials": {
"user_pass": {
"username": "<username>",
"password": "<password>"
}
}
}
]
}
]
},
"config_override": "<config_override>"
}' \
"$RMS_ADDR" rack_manager_v2.RackManagerV2/StartSystemValidation