Exigences pour les fournisseurs

Tout ce qu’il faut à une machine avant d’héberger des sessions Community, et comment le vérifier vous-même. Comptez environ 15 minutes, plus un redémarrage.

La machine

Tout vérifier d’un coup

Sur la machine, dans un 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 /

Noyau inférieur à 6.12 : installez le noyau HWE, puis redémarrez.

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

nvidia-smi ne répond que si le pilote NVIDIA est chargé. Une fois le GPU réservé aux sessions (voir VFIO plus bas), il n’y apparaît plus : c’est normal.

Firmware (BIOS ou UEFI)

Ouvrez la configuration du firmware au démarrage (souvent Suppr, F2 ou F10) et réglez :

Les noms varient selon les cartes mères. Cherchez sous Advanced, CPU Configuration, Chipset ou North Bridge. Enregistrez, puis démarrez Ubuntu.

IOMMU sur la ligne de commande du noyau

Sur les cartes mères Intel, l’IOMMU doit aussi être activé dans le noyau. Sur AMD, il l’est par défaut; la même ligne ne gêne pas.

1. Modifiez /etc/default/grub et ajoutez à GRUB_CMDLINE_LINUX_DEFAULT :
   • Intel : intel_iommu=on iommu=pt
   • AMD : amd_iommu=on iommu=pt
2. Exécutez sudo update-grub, puis redémarrez.
3. Vérifiez : cat /proc/cmdline affiche les options, et ls /sys/kernel/iommu_groups liste des groupes.

N’ajoutez jamais pcie_acs_override. Cette option simule l’isolation entre périphériques, et une machine qui l’utilise est refusée à la vérification.

Chaque GPU dans son propre groupe IOMMU

Un GPU loué est attaché à une seule VM, avec tous les périphériques de son groupe IOMMU. Listez les groupes :

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

Chaque GPU NVIDIA ne doit partager son groupe qu’avec ses propres fonctions (son périphérique audio, parfois un contrôleur USB sur la carte) et des ponts PCI. Si un GPU partage un groupe avec un contrôleur de disque ou une carte réseau, déplacez-le dans un autre emplacement PCIe, de préférence relié au CPU.

VFIO

Les sessions accèdent au GPU par vfio-pci, le pilote Linux qui confie un périphérique à une VM. L’installation de l’hôte Community réserve les GPU loués pour vous. Pour le vérifier, ou le configurer à la main :

1. Trouvez les identifiants du GPU et de sa fonction audio : lspci -nn -d 10de: (par exemple [10de:2684] et [10de:22ba]).

2. Créez /etc/modprobe.d/vfio.conf avec :

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

3. Exécutez sudo update-initramfs -u, puis redémarrez.

4. Vérifiez : lspci -nnk -d 10de: affiche Kernel driver in use: vfio-pci pour chaque fonction louée.

Deux cartes du même modèle partagent leurs identifiants : les deux sont réservées. Gardez une carte différente, ou la puce graphique intégrée, pour la console.

L’autotest

L’agent Node Lodge exécute les mêmes vérifications et vous indique quoi corriger. Sur la machine, dans le dossier de l’agent :

node compute-host.mjs doctor --community

Il lit la machine sans rien modifier. Chaque ligne indique pass, warn ou fail :

Corrigez chaque fail avant d’appairer la machine. Ensuite : Appairer une machine.