Skip to content

virtum doctor ​

virtum doctor checks that the host is ready to run VMs. Run it after installing, and whenever a command fails for no clear reason.

console
$ virtum doctor
Virtum doctor

  [ok]   qemu-img
  [ok]   virsh
  [ok]   cloud-localds
  [ok]   ssh
  [ok]   socat
  [ok]   virtiofsd (/usr/libexec/virtiofsd)
  [ok]   AppArmor virtiofs (Virtum) — …
  [ok]   KVM (/dev/kvm)
  [ok]   Groupes libvirt et kvm
  [ok]   Réseau libvirt « default »
  [ok]   Réseau bridge (LAN physique) — …
  [ok]   Stockage Virtum (libvirt système) — Répertoire actif : /var/lib/virtum
  [ok]   Images de base des VM — …
  [ok]   Restes orphelins — …
  [ok]   ansible-playbook — …

Toutes les vérifications ont réussi (15/15).

Every check must be [ok]. A failing line tells you what to fix, for example the package to install. Virtum's messages are in French.

What is checked ​

CheckWhat it verifies
qemu-img, virsh, cloud-localds, ssh, socatThe tools are installed (qemu-utils, libvirt-clients, cloud-image-utils, openssh-client, socat); socat is used by ports:
virtiofsdPresent, and able to enforce read-only shares
AppArmor virtiofsAppArmor does not block virtiofsd sockets under /var/lib/virtum
KVM (/dev/kvm)Hardware virtualization is available
Groupes libvirt et kvmYour account is a member of the libvirt and kvm groups
Réseau libvirt « default »The NAT network used by virtum run
Réseau bridge (LAN physique)The recommended interface for bridging; warns if it is Wi-Fi
Stockage VirtumThe active directory (/var/lib/virtum or ~/.virtum)
Images de base des VMVM disks still find their base image
Restes orphelinsLeftover libvirt domains or instance folders with no known VM, with the commands to clean them up
ansible-playbookIts version, or that it is missing; never blocking, it is only needed for the ansible: section

The matching packages: Installation. Common failures: Troubleshooting.