Requisitos del proveedor

Todo lo que una máquina necesita antes de alojar sesiones Community, y cómo comprobarlo usted mismo. Cuente unos 15 minutos y un reinicio.

La máquina

Compruébelo de una vez

En la máquina, en una terminal:

lsb_release -ds; uname -r; nvidia-smi --query-gpu=name,memory.total --format=csv,noheader; ls /dev/kvm; ls /sys/kernel/iommu_groups | wc -l; df -h /

¿Kernel inferior a 6.12? Instale el kernel HWE y reinicie.

sudo apt install linux-generic-hwe-24.04 && sudo reboot

nvidia-smi solo responde mientras el controlador NVIDIA está cargado. Cuando la GPU queda reservada para las sesiones (consulte VFIO más abajo), deja de aparecer ahí: es lo esperado.

Firmware (BIOS o UEFI)

Abra la configuración del firmware al arrancar (normalmente Supr, F2 o F10) y ajuste:

Los nombres varían según la placa. Busque en Advanced, CPU Configuration, Chipset o North Bridge. Guarde y arranque Ubuntu.

IOMMU en la línea de comandos del kernel

Las placas Intel también necesitan activar el IOMMU en el kernel. En AMD está activado por defecto; la misma línea no causa ningún problema.

1. Edite /etc/default/grub y añada a GRUB_CMDLINE_LINUX_DEFAULT:
   • Intel: intel_iommu=on iommu=pt
   • AMD: amd_iommu=on iommu=pt
2. Ejecute sudo update-grub y reinicie.
3. Compruebe: cat /proc/cmdline muestra las opciones y ls /sys/kernel/iommu_groups lista los grupos.

Nunca añada pcie_acs_override. Falsea el aislamiento entre dispositivos, y una máquina que lo usa no supera la revisión.

Cada GPU en su propio grupo IOMMU

Una GPU alquilada se asigna a una VM, junto con todos los dispositivos que comparten su grupo IOMMU. Liste los grupos:

for g in /sys/kernel/iommu_groups/*; do echo "Group ${g##*/}"; for d in "$g"/devices/*; do echo "  $(lspci -nns "${d##*/}")"; done; done

Cada GPU NVIDIA debe compartir su grupo solo con sus propias funciones (su dispositivo de audio, a veces un controlador USB de la tarjeta) y con puentes PCI. Si una GPU comparte grupo con una controladora de disco o una tarjeta de red, muévala a otra ranura PCIe, preferiblemente una conectada a la CPU.

VFIO

Las sesiones acceden a la GPU mediante vfio-pci, el controlador de Linux que cede un dispositivo a una VM. La instalación del host Community reserva las GPU alquiladas por usted. Para comprobarlo, o configurarlo a mano:

1. Busque los ID de la GPU y de su función de audio: lspci -nn -d 10de: (por ejemplo [10de:2684] y [10de:22ba]).

2. Cree /etc/modprobe.d/vfio.conf con:

   options vfio-pci ids=10de:2684,10de:22ba
   softdep nvidia pre: vfio-pci
   softdep nouveau pre: vfio-pci
   

3. Ejecute sudo update-initramfs -u y reinicie.

4. Compruebe: lspci -nnk -d 10de: muestra Kernel driver in use: vfio-pci para cada función alquilada.

Dos tarjetas del mismo modelo comparten sus ID: ambas quedan reservadas. Reserve una tarjeta distinta, o los gráficos integrados, para la consola.

El autodiagnóstico

El agente de Node Lodge ejecuta las mismas comprobaciones y le indica qué corregir. En la máquina, en la carpeta del agente:

node compute-host.mjs doctor --community

Lee la máquina y no modifica nada. Cada línea es pass, warn o fail:

Corrija cada fail antes de emparejar la máquina. Siguiente paso: Emparejar una máquina.