> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.nvidia.com/rms/llms.txt.

# System Validation


Start NVSSVT system validation scans on nodes.

| RPC | Execution | Summary |
| --- | --- | --- |
| [`StartSystemValidation (V2)`](#startsystemvalidation-v2) | Asynchronous, parent and child jobs | StartSystemValidation 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](/rms/api-reference/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.

<Warning>
Each node's scan runs as its own job. A failure to admit or launch one node does not affect the other nodes.
</Warning>

| Property | Value |
| --- | --- |
| Execution | **Asynchronous, parent and child jobs.** The response returns a parent job ID and the work continues after the call returns. |
| Job tracking | Poll [`GetJobStatus`](/rms/api-reference/rpcs/utility-jobs#getjobstatus) with the job ID in `response.job_id`. Per-node child job IDs are in `jobs`. |
| Job result | `result_json` in the job status holds the parsed status and the summary report for that node's scan. |
| Target | **Caller-supplied nodes.** The request carries each node's endpoints and credentials, and RMS does not store them. |
| Behavior details | [Operations guide](/rms/documentation/operations/system-validation) |
| Protobuf reference | [`StartSystemValidation`](/rms/api-reference/protobuf-reference/rack-manager-v-2/rack-manager-v-2/rack-manager-v-2-start-system-validation) |

**Request:** [`StartSystemValidationRequest`](/rms/api-reference/types/rack-manager-v2#startsystemvalidationrequest)

| Field | Type | Description |
| --- | --- | --- |
| `nodes` | [`NodeSet`](/rms/api-reference/types/rack-manager#nodeset) | - |
| `config_override` | `string` | Passed 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`](/rms/api-reference/types/rack-manager-v2#startsystemvalidationresponse)

| Field | Type | Description |
| --- | --- | --- |
| `response` | [`NodeBatchResponse`](/rms/api-reference/types/rack-manager#nodebatchresponse) | response.job_id is the parent job ID for GetJobStatus |
| `jobs` | repeated [`NodeSystemValidationJobInfo`](/rms/api-reference/types/rack-manager-v2#nodesystemvalidationjobinfo) | Individual scan job ID per node |

**Errors:** Refer to [Conventions](/rms/api-reference/conventions#error-handling) for how RMS reports failures.

<Accordion title="Example request">

Replace each `<placeholder>` with a real value. Define `RMS_GRPCURL_FLAGS` and `RMS_ADDR` as described in [Getting started](/rms/api-reference/getting-started#call-an-rpc-with-grpcurl).

```bash
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
```

</Accordion>