Skip to content

Spyre Setup

Sourabh Jain edited this page Oct 30, 2025 · 1 revision

Spyre card configuration setup using ServiceReport

ServiceReport is a plugin-based tool that assists with the Spyre card setup. This section covers three aspects: validating the Spyre card configuration, fixing any incorrect setup, and ensuring the user is added to the sentient group.

Validate Spyre card setup

$ sudo servicereport -v -p spyre

The command verifies all Spyre card-related configurations and displays the status of each check. If this command is run after a fresh system is installed, it is expected that the status of the configuration checks will be 'FAIL'. However, even if some of the configuration checks pass, proceed to the next step.

Diagram

Fix incorrect Spyre setup

$ sudo servicereport -r -p spyre

Repair all incorrect Spyre card configurations. This includes setting up VFIO device bindings for the VFIO kernel module, configuring VFIO udev rules, adding the 'sentient' user group, setting memory limits for the 'sentient' group, inserting the VFIO modules, etc.

Diagram

Add user to sentient group

$ usermod -aG sentient <user>

Add the user who is expected to run the Spyre workload to the 'sentient' group. This will help the user inherit the necessary permissions to run the workload properly. For example: abc user is added to sentient group

Diagram

Clone this wiki locally