Skip to content

System Validation (rblnvs)

rblnvs is a system diagnostic tool that validates server configuration (GRUB and BIOS settings) to verify that a host meets the prerequisites for running RBLN NPUs.

Note

  • BIOS validation requires 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 specified with -t, --target:

  • grub: Validates kernel/boot parameters for optimal NPU performance.
  • bios: Validates BIOS settings.
  • all: Runs all supported targets.

BMC (Redfish) credentials

Note

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

  • --bmc_user <BMC_USER> / --bmc_password <BMC_PASSWORD>: BMC credentials

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, or all.
-l, --list List available targets.
--bmc_user <BMC_USER> BMC user.
--bmc_password <BMC_PASSWORD> BMC password.

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

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_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 Check ====
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

Troubleshooting

bios 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