Dépannage
Commencez toujours par virtum doctor : chaque contrôle en échec indique quoi corriger. Voir virtum doctor.
virtum doctor signale KVM en échec
Virtum n'a pas accès en lecture et écriture à /dev/kvm. Vérifiez que la virtualisation KVM est activée dans le BIOS/UEFI, et que votre compte est dans le groupe kvm (voir ci-dessous), puis relancez virtum doctor.
Groupes libvirt et kvm en échec
Votre compte doit être membre des groupes libvirt et kvm :
sudo usermod -aG libvirt,kvm $USERL'ajout ne prend effet qu'à la session suivante : déconnectez-vous puis reconnectez-vous.
Un outil est introuvable
doctor indique le paquet à installer pour chaque outil manquant (qemu-utils, libvirt-clients, cloud-image-utils, openssh-client, socat, virtiofsd). Avec l'archive, sudo ./scripts/setup-host.sh les installe sur Debian et Ubuntu.
virtum : commande introuvable
Avec l'archive, le binaire est installé dans ~/.local/bin, qui doit être dans votre PATH. Depuis les sources, make install l'installe dans ~/.cargo/bin.
Les dossiers partagés ne fonctionnent pas
- Sur Ubuntu 22.04 et Debian 12,
virtiofsdn'existe pas en paquet séparé : les dossiers partagés n'y sont pas pris en charge. - Si
doctorsignale « AppArmor virtiofs », AppArmor bloque les sockets virtiofsd sous/var/lib/virtum; la ligne en échec indique la correction. - Un partage
rwne peut contenir ni le Virtumfile ni les fichiers Ansible, et les partages ne s'imbriquent pas :virtum plansignale ces erreurs.
plan ou up refuse le sous-réseau
Le sous-réseau du lab chevauche un réseau existant. Choisissez un autre subnet: dans le Virtumfile, ou changez le nom du lab si le sous-réseau est calculé. Voir Réseau et bridge.
Le bridge ne marche pas
Le Wi-Fi est souvent incompatible avec le bridge : préférez une interface Ethernet, désignée par --bridge-interface ou bridge_interface:. virtum doctor affiche l'interface recommandée et avertit si c'est du Wi-Fi.
Un port n'est pas joignable depuis une autre machine
Par défaut, les ports: n'écoutent que sur 127.0.0.1. Pour le réseau local, déclarez bind: lan, puis virtum open si l'hôte utilise ufw. Voir Ports et accès LAN.
Restes de VM après un échec
virtum doctor liste, sous « Restes orphelins », les domaines libvirt et dossiers d'instance sans VM connue, avec les commandes pour les nettoyer. Vérifiez avant de supprimer.
Une machine retirée du Virtumfile existe toujours
C'est voulu : plan la signale, virtum apply --prune la supprime.
Signaler un bug
Ouvrez un ticket sur le dépôt GitHub avec la version (virtum --version) et la sortie de virtum doctor. Pour une faille de sécurité, écrivez plutôt à security@virtum.dev (voir Sécurité).