Skip to content

System Validation (rblnvs)

rblnvs is a system diagnostic tool that validates server configuration (GRUB/BIOS) and checks system health telemetry (for example, fan RPM) to verify host prerequisites for RBLN NPUs.

Note

  • BIOS validation and fan RPM checks require BMC access via the Redfish API.
  • rblnvs is currently supported only on Supermicro servers with a DCMS license.

Quick Start

$ sudo rblnvs -t grub -v

Key Concepts and Terminology

Validation targets

rblnvs validates one or more targets via -t, --target:

  • grub: Validates kernel/boot parameters for optimal NPU performance.
  • bios: Validates BIOS settings.
  • fanspeed: Reads fan RPM and status.
  • all: Runs all supported targets.

BMC (Redfish) credentials

Note

For targets that access the BMC (bios, fanspeed), provide:

  • --bmc_ip <BMC_IP>: BMC IP address (Redfish endpoint)
  • --bmc_user <BMC_USER> / --bmc_password <BMC_PASSWORD>: BMC credentials

Output format

  • Text (default): Human-readable report for interactive use.
  • JSON (-j, --json): Machine-readable output for scripts and automation.

Command Reference

General usage

$ rblnvs -l
$ rblnvs -t <target> [options]
$ rblnvs -t <target1> <target2> ... [options]

Note

Some checks may require root privileges. If you see permission-related errors, rerun the command with sudo.

Tip

For the full, version-specific option reference, run rblnvs --help.

Global options

Option Description
-h, --help Show help message and exit.
-v, --verbose Verbose output (for example, show detailed parameter checks).
--version Show version information and exit.
-t, --target <TARGET ...> Validate target(s): grub, bios, fanspeed, or all.
-l, --list List available targets.
--bmc_ip <BMC_IP> BMC IP address (Redfish endpoint).
--bmc_user <BMC_USER> BMC user.
--bmc_password <BMC_PASSWORD> BMC password.
-j, --json Output in JSON format.

CLI Examples

Summary

Lists available validation targets on the current system.

Command

Command
$ rblnvs -l

Output (example)

Targets list (example)
Rebellions Validation Suite (version: 3.0.0)

Available targets:
        grub
        bios
        fanspeed

Summary

Validates kernel/boot parameters. Use -v, --verbose to show detailed parameter checks.

Command

Command
$ sudo rblnvs -t grub

Output (example)

GRUB validation (example)
Rebellions Validation Suite (version: 3.0.0)

==== System Information ====
OS                 : ubuntu 22.04.5 LTS (Jammy Jellyfish)
Kernel             : 6.8.0-90-generic
CPU Model          : AMD EPYC 9254 24-Core Processor
Manufacturer       : Supermicro
Architecture       : x86_64

==== GRUB Boot Parameter ====
Result             : PASS

Summary

Validates BIOS settings.

Command

Command
$ sudo rblnvs -t bios --bmc_ip 192.168.10.100 --bmc_user admin --bmc_password password123

Output (example)

BIOS validation (example)
Rebellions Validation Suite (version: 3.0.0)

==== System Information ====
OS                 : ubuntu 22.04.5 LTS (Jammy Jellyfish)
Kernel             : 6.8.0-90-generic
CPU Model          : AMD EPYC 9254 24-Core Processor
Manufacturer       : Supermicro
Architecture       : x86_64

==== BIOS Settings ====
Setting                               Status
---------------------------------------------------
IOMMU                               ✓ Enabled
SR_IOVSupport                       ✓ Enabled
Above4GDecoding                     ✓ Enabled
Re_SizeBARSupport                   ✓ Enabled
ASPMSupport                         ✓ Auto
DFCStates                           ✓ Disabled
NUMANodesPerSocket                  ✓ NPS1
ACPISRATL3CacheAsNUMADomain         ✓ Disabled
MMIO High Base                      N/A
MMIO High Granularity Size          N/A
SNC (Intel)                         N/A

Summary

Retrieves fan RPM values and status.

Command

Command
$ sudo rblnvs -t fanspeed --bmc_ip 192.168.10.100 --bmc_user admin --bmc_password password123

Output (example)

Fan speed (example)
Rebellions Validation Suite (version: 3.0.0)

==== System Information ====
OS                 : ubuntu 22.04.5 LTS (Jammy Jellyfish)
Kernel             : 6.8.0-90-generic
CPU Model          : AMD EPYC 9254 24-Core Processor
Manufacturer       : Supermicro
Architecture       : x86_64

==== Fan Speed ====
Result             PASS
Fan                Speed(RPM)    Status
---------------------------------------------------
FAN1                       3920    enabled
FAN2                       3920    enabled
FAN3                       3920    enabled
FAN4                       3920    enabled
FAN5                       3780    enabled
FAN6                       3920    enabled
FAN7                       3920    enabled
FAN8                       3920    enabled
FAN9                       2380    enabled
FAN10                      2240    enabled

Summary

Emits JSON output for scripts and automation. Combine with any target (example below uses fanspeed).

Command

Command
$ sudo rblnvs -t fanspeed --bmc_ip 192.168.10.100 --bmc_user admin --bmc_password password123 -j

Output (example)

JSON output (example)
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
{
  "version": "3.0.0",
  "system_information": {
    "os": "ubuntu 22.04.5 LTS (Jammy Jellyfish)",
    "kernel": "6.8.0-90-generic",
    "cpu_model": "AMD EPYC 9254 24-Core Processor",
    "manufacturer": "Supermicro",
    "architecture": "x86_64"
  },
  "fan_speed": {
    "result": "pass",
    "fans": [
      {
        "name": "FAN1",
        "speed_rpm": 3920,
        "status": "enabled"
      },
      {
        "name": "FAN2",
        "speed_rpm": 3920,
        "status": "enabled"
      },
      {
        "name": "FAN3",
        "speed_rpm": 3920,
        "status": "enabled"
      },
      {
        "name": "FAN4",
        "speed_rpm": 3920,
        "status": "enabled"
      },
      {
        "name": "FAN5",
        "speed_rpm": 3780,
        "status": "enabled"
      },
      {
        "name": "FAN6",
        "speed_rpm": 3920,
        "status": "enabled"
      },
      {
        "name": "FAN7",
        "speed_rpm": 3920,
        "status": "enabled"
      },
      {
        "name": "FAN8",
        "speed_rpm": 3920,
        "status": "enabled"
      },
      {
        "name": "FAN9",
        "speed_rpm": 2380,
        "status": "enabled"
      },
      {
        "name": "FAN10",
        "speed_rpm": 2240,
        "status": "enabled"
      }
    ]
  }
}

Troubleshooting

bios / fanspeed fails

  • Confirm the host can reach the BMC and that the Redfish endpoint is accessible.
  • Verify BMC credentials (see BMC (Redfish) credentials).

Unsupported platform

rblnvs is currently supported only on Supermicro servers with a DCMS license.

See also