Skip to main content

SupremeRAID™ Provision User Guide

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 Distributionx86_64
AlmaLinux8.6, 8.9, 8.10, 9.2, 9.4, 9.5, 9.6, 10.0
CentOS7.9
Debian11.6, 12.2, 12.8, 12.9, 13.0, 13.2
openSUSE Leap15.2, 15.3, 15.4, 15.5, 15.6
Oracle Linux8.5, 8.7, 8.9, 9.1, 9.3, 9.4, 9.5, 9.6, 9.7, 10.0, 10.1
RHEL8.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 VE8.2.2, 8.3.1, 9.0
Rocky Linux8.9, 9.2, 9.3, 9.4, 9.5, 9.6, 10.0, 8.10
Ubuntu20.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!