TECHNICAL GUIDE
GPU & Guest Tools · GT-02

Install STRATUM Guest Tools

Install STRATUM Guest Tools inside the VM to add the guest agent and the STRATUM GPU user-mode driver/runtime integration used by CUDA and NVML applications.

GUEST TOOLS

Install inside the guest

Mount or attach the Guest Tools media to the VM, run the installer inside the guest, and allow the package to install the guest agent and STRATUM GPU integration.

After installation, verify that the validation summary succeeds and that the stratum-guest-agent service is active.

PROCEDURE

Procedure

STEP 01

Install Guest Tools

Attach the Guest Tools media, mount it inside the guest, and run the supplied install script. Let the installation finish before restarting or validating the agent.

FIGURE 01Install Guest Tools

Commands

Use the Guest Tools CD-ROM assigned to this guest; the Linux device path can vary. The installer may need access to OS package repositories or a prepared offline mirror.

shell
# Inside the guest: adapt /dev/sr1 to the attached Guest Tools media
sudo mkdir -p /mnt/stratum-guest-tools
sudo mount -o ro /dev/sr1 /mnt/stratum-guest-tools
ls -la /mnt/stratum-guest-tools
sudo /mnt/stratum-guest-tools/install.sh --install-deps
STEP 02

Guest Tools Installation Complete

The validation summary should report the guest agent and required GPU integration components as installed successfully.

FIGURE 02Guest Tools Installation Complete
STEP 03

Guest Agent Service Status

Check the stratum-guest-agent service after installation. It should be loaded and active inside the guest.

FIGURE 03Guest Agent Service Status

Commands

The service should report active. On other guest distributions, consult the service manager used by that operating system.

shell
# Confirm the guest agent was installed and is active
systemctl status stratum-guest-agent --no-pager
systemctl is-active stratum-guest-agent
RESULT

The outcome you should see

Guest Tools validation succeeds and the guest agent is active.