SupremeRAID™ Provision User Guide

Jan. 28, 2026

Date:1/28/26

Notes

SupremeRAID™ Provision is currently in beta. If you encounter any issues or have any feedback while using it, please contact us through the Support Portal.

About this document

This guide describes the use of SupremeRAID™ Provision for bulk license deployment across multiple machines. It aims to minimize manual data entry errors and shorten deployment lead times, while also supporting bulk collection of hardware information and GPU serial numbers/UUIDs and license application across multiple systems.

Supported Operating Systems

Linux Distribution	x86_64
AlmaLinux	8.6, 8.9, 8.10, 9.2, 9.4, 9.5, 9.6, 10.0
CentOS	7.9
Debian	11.6, 12.2, 12.8, 12.9, 13.0, 13.2
openSUSE Leap	15.2, 15.3, 15.4, 15.5, 15.6
Oracle Linux	8.5, 8.7, 8.9, 9.1, 9.3, 9.4, 9.5, 9.6, 9.7, 10.0, 10.1
RHEL	8.6, 8.8, 8.9, 9.0, 9.1, 9.2, 9.3, 9.4, 9.5, 9.6, 9.7, 10.0, 10.1
Proxmox VE	8.2.2, 8.3.1, 9.0
Rocky Linux	8.9, 9.2, 9.3, 9.4, 9.5, 9.6, 10.0, 8.10
Ubuntu	20.04, 22.04.2, 22.04.3, 22.04.4, 24.04

Usage Steps

Step 1: Download SupremeRAID™ Provision
Download: graid-provision
md5 :c3780cace46a1f84822c23af9ef6d986
Important Notes
Your driver version must be 2.0.0 or later to use Graid Provision. For the driver package download, please refer to the latest release notes.
Step 2: Generate the configuration file
Please use the following command to generate the configuration file.
```
graid-provision init-config -o config.yml
```

Step 3: Edit the configuration file
Edit the following information according to your requirements. The example is provided below:

ssh_user: "admin"
ssh_password: "password"  # Also used for sudo operations
ssh_key: ""               # Optional: path to SSH private key (e.g., ~/.ssh/id_rsa)
                        # Note: sudo operations still require ssh_password
ssh_port: 22
api_port: 50061
operation_timeout: 30     # 0 = no timeout

hosts:
  includes:
    - ip: "172.16.49.1-10"              # IP range
    - ip: "192.168.1.100"               # Single IP
    - ip: "10.0.0.1-5,10.0.0.10-15"    # Multiple ranges
  
    # Override credentials for specific range
    - ip: "172.16.50.1-5"
      ssh_user: "root"
      ssh_password: "different_pass"

  excludes:
    - ip: "172.16.49.5"                 # Exclude specific IPs
    - ip: "192.168.1.103-105"          # Exclude range

Step 4: Collect GPU Serial Number & UUID
Please use the following command to collect the GPU serial number or UUID.

graid-provision collect-hardware-info [-o output_path] [-i config_path] [-s 0-15] [-m T400/T1000/A2000/...] [-a] [--id-field serial|uuid]

Parameters:
-i: (Required) Config file path
-o: (Required) Output CSV file path
-m: (Optional) Filter by GPU model name
-s: (Optional) Filter by PCIe slot number (0-15). If not specified, the smallest slot ID is automatically selected.
-a: (Optional) Collect all GPUs matching the criteria instead of just one
--id-field: (Optional) Preferred ID field to collect (serial|uuid, default: serial)
serial: Prioritizes serial number, falls back to UUID if serial is empty
uuid: Prioritizes UUID, falls back to serial number if UUID is empty

Example

graid-provision collect-hardware-info -i ./config.yml -o ./hardware.csv

hardware.csv Example:

GPU Serial Number/UUID
1230000000000
0980000000000

Step 5: Check GPU Serial Number & UUID CSV
Please use the following command to check the GPU serial number or UUID.
```
cat <csv_file_path>
```
Example
```
cat ./hardware.csv
```
Step 6: Generate License via SupremeRAID™ Portal
- Please log in to the SupremeRAID™ Portal and upload the GPU serial number/UUID CSV generated in the previous step to generate license.
- Please refer to Step 6 : Enter GPU Information for the detail instructions.
- After generating the license, please export it as a CSV file.
License CSV example:
```
  GPU Serial Number/UUID,License Key
  1234567890987,1EXXXXXX-IXXXXXXX-SXXXXXXX-1XXXXXXX
  0987654321123,2FXXXXXX-JXXXXXXX-TXXXXXXX-2XXXXXXX
```

Step 7: Apply License
Please use the following command to apply license.

graid-provision apply-license <license_file_path> -i <inventory_path>

Parameters:
{license_list_file}: (Required) Path to the CSV file containing GPU serial numbers/UUIDs and corresponding license keys
-i: (Required) Config file path

Example

graid-provision apply-license ./license.csv -i ./config.yml

Output Example

--------------------------------------------------
TASK [get SupremeRAID™ service token]: 1 hosts (0 excluded)
- 172.16.99.102: OK
success=1 failed=0 completed=0 cancelled=0

--------------------------------------------------
TASK [get SupremeRAID™ service license status]: 1 hosts (0 excluded)
- 172.16.99.102: OK
success=1 failed=0 completed=0 cancelled=0

--------------------------------------------------
TASK [get SupremeRAID™ service GPUs info]: 1 hosts (0 excluded)
- 172.16.99.102: OK
success=1 failed=0 completed=0 cancelled=0

--------------------------------------------------
TASK [match licenses info]: 1 hosts (0 excluded)
- 172.16.99.102: OK
success=1 failed=0 completed=0 cancelled=0

--------------------------------------------------
TASK [apply license to SupremeRAID™ service]: 1 hosts (0 excluded)
- 172.16.99.102: OK
success=1 failed=0 completed=0 cancelled=0

Report saved to: reports/20260128_112049_apply-license_60e97754.txt
License application completed successfully!