Passer au contenu principal

Configuration de VM

La configuration d'une machine virtuelle (VM) sur Unraid est un moyen flexible d'exécuter des systèmes d'exploitation complets - comme Windows, Linux, ou d'autres plateformes - aux côtés de vos conteneurs et applications natives. Que vous souhaitiez tester de nouveaux logiciels, exécuter des applications anciennes, héberger un environnement de bureau, ou utiliser le passage matériel pour le jeu ou le travail créatif, le Gestionnaire de VM d'Unraid rend le processus accessible à tous les niveaux de compétence.

New dans Unraid 7.0

Unraid 7.x apporte des améliorations significatives aux machines virtuelles (VM), notamment :

  • Clones et instantanés des VM
  • Modèles de VM créés par l'utilisateur
  • Edition/visualisation XML en ligne
  • Fonctionnalités avancées de partage et de passage GPU

Consultez la section fonctionnalités du gestionnaire de VM pour plus de détails.

Si vous ne l'avez pas déjà fait, veuillez consulter les instructions Aperçu & préparation système pour vous assurer que votre matériel et vos partages sont prêts pour la virtualisation.

Créer vos propres machines virtuelles​

Une fois votre système préparé et vos préférences définies, vous pouvez créer une nouvelle machine virtuelle (VM) en utilisant le WebGUI.

Before vous commencez
  • Confirmez que vos partages isos et domains sont configurés et accessibles. Découvrez-en plus sur la gestion des partages ici.
  • Téléchargez votre ISO d'installation du système d'exploitation et, pour les VMs Windows, l'ISO des derniers pilotes VirtIO sur le partage isos.
  • Décidez si vous utiliserez le GPU passthrough ou le VNC pour les graphiques.

Pour créer une VM basique :

  1. Cliquez sur Ajouter une VM dans la page Machines Virtuelles.
  2. Définissez le Modèle sur Personnalisé, ou sélectionnez un modèle de système d'exploitation prédéfini pour les distributions courantes.
  3. Entrez un Nom et, si vous le souhaitez, une Description pour votre VM.
  4. Basculez Démarrage automatique si vous souhaitez que le VM démarre automatiquement avec le array.
  5. Sélectionnez le type de Système d'Exploitation. Cela ajustera également l'icône VM.
  6. Affectez des cœurs CPU à la VM. Vous pouvez affecter jusqu'au nombre de cœurs physiques disponibles sur votre hôte.
  7. Spécifiez la Mémoire Initiale (RAM) pour la VM. Consultez la documentation de votre OS invité pour obtenir les valeurs recommandées.
  8. Choisissez l'ISO d'installation de l'OS dans votre partage isos.
  9. Configurez le disque vDisk principal (emplacement, taille, et type).
    • Le vDisk principal stocke le système d'exploitation de la VM.
    • Ajoutez des vDisques supplémentaires au besoin à l'aide du signe plus.
  10. Sélectionnez une Carte Graphique :
    • Choisissez VNC pour un accès à distance ou sélectionnez un GPU physique pour le passage.
    • Attribuez un clavier/souris USB si vous utilisez un GPU physique.
    • Définissez un mot de passe pour VNC si désiré.
  11. Attribuez une Carte Son (optionnel, mais nécessaire pour l'audio HDMI via GPU).
  12. Assignez des Périphériques USB selon les besoins.
    • Les dispositifs doivent être attachés avant de démarrer la VM (le branchement à chaud USB n'est pas supporté).
    • Le périphérique USB Unraid n'est pas disponible pour l'affectation.
  13. Cliquez sur Créer la VM. La VM démarrera automatiquement à moins que vous ne décochiez Démarrer la VM après la création.

Modèles VM utilisateur​

Unraid 7.1+ introduit des modèles d'utilisateur VM, simplifiant la sauvegarde et la réutilisation de vos configurations personnalisées VM. Les modèles d'utilisateur rationalisent le déploiement VM et assurent la cohérence des configurations.

Pour créer un modèle utilisateur :

  1. Modifiez la VM que vous souhaitez modéliser.
  2. Sélectionnez Créer/Modifier un modèle et entrez un nom.
  3. Votre modèle sera maintenant disponible dans l'espace des modèles utilisateur sur l'écran Ajouter une VM.

Pour utiliser un modèle utilisateur :

  • Sur la page VMs, cliquez sur ajouter une VM et sélectionnez votre modèle dans la section modèles utilisateur.

Importation/exportation :

  • Survolez un modèle utilisateur et cliquez sur la flèche pour l'exporter vers votre serveur ou le télécharger.
  • Sur un autre système Unraid, utilisez Importer à partir d'un fichier ou Télécharger pour ajouter le modèle.

Nouveautés dans Unraid 7.x : Gestionnaire de VM​

Unraid 7.x introduit une gamme d’améliorations puissantes au Gestionnaire de VM, simplifiant le processus d'exécution et de gestion des machines virtuelles. Ces fonctionnalités s'adressent tant aux débutants qu'aux utilisateurs avancés, rendant le déploiement, la personnalisation et l'optimisation de vos VM plus simples.

Highlights
  • Gagnez du temps avec des clones de VM, instantanés, et des modèles réutilisables
  • Ajustez finement la performance et la compatibilité avec des options avancées de passage et de stockage
  • Profitez de la visibilité et du contrôle améliorés avec des statistiques d'utilisation et une édition XML en ligne
Améliorations du flux de travail
  • Clones & instantanés de VM : Dupliquez des VMs ou sauvegardez/restaurez rapidement leur état pour des tests ou des sauvegardes.
  • Modèles de VM utilisateur : Sauvegardez vos configurations VM personnalisées et déployez de nouvelles VMs en quelques clics.
  • Edition/visualisation XML en ligne : Visualisez ou copiez instantanément le XML généré par le WebGUI ; passez en mode XML pour des éditions avancées.
  • Désactivation du démarrage automatique : Choisissez quels VMs démarrent automatiquement avec votre array.
  • Statistiques d'utilisation de VM : Suivez l'utilisation des ressources par VM directement depuis le tableau de bord.
Options de matériel avancées & stockage
  • PCI multifonction/autre : Assignez des dispositifs PCI complexes ou des groupes pour des scénarios avancés de passage.
  • Passage en ligne de commande QEMU : Ajoutez des arguments QEMU personnalisés pour un réglage expert des VM.
  • Remplacement de stockage : Spécifiez l'emplacement de stockage pour chaque disque virtuel de VM.
  • Indicateur SSD & deslocage : Optimisez la performance des vDisques pour les SSD et activez le support discard/unmap.
  • SR-IOV pour iGPU Intel : Partagez les graphiques intégrés Intel entre plusieurs VMs.
  • Validation du nom de VM pour ZFS : Empêchez l'utilisation de caractères non pris en charge dans les noms de VM pour les pools ZFS.
Graphismes améliorés et partage de GPU
  • GPUs virtuels VirGL & QXL : Partagez les GPUs Intel/AMD entre plusieurs VMs Linux ou utilisez QXL pour des options multi-écrans/mémoire.
  • Mise en épingle CPU optionnelle : Autorisez Unraid à gérer automatiquement l'allocation CPU ou fixez manuellement des cœurs selon les besoins.
Fonctionnalités plus avancées
  • View all graphics cards and VM-assigned IP addresses in the VM tab
  • Support pour la cible QEMU ppc64 et qemu:override
  • Support hypervclock pour les VMs Windows
  • "Migratable" activé/désactivé pour le CPU émulé
  • Options de configuration du Timer/décalage
  • Pas d'options de keymap/nogpu disponibles pour des cas d'utilisation spécifiques
  • Amélioration de la sélection et de l'édition des icônes de VM
  • Avertissements lors de l'affectation du GPU principal comme passage (peut nécessiter vBIOS)
  • Démarrez les VMs Unraid en mode GUI avec le pilote vidéo QXL
  • Divers correctifs pour les problèmes de chemin et d'icône dans la vue XML

Utilisation des GPUs virtuels et partage GPU​

Unraid supporte désormais le partage avancé de GPU via VirGL et QXL pour les VMs Linux (et certains GPUs Nvidia avec le driver Nouveau).

  • Pour utiliser VirGL : définissez la Carte Graphique sur Virtuel et le pilote vidéo de la console VM sur VirtIO(3D).
  • Pour utiliser QXL : définissez la Carte Graphique sur Virtuel et le pilote vidéo de la console VM sur QXL (meilleur).
  • VirGL n'output pas vers un moniteur physique et n'est pas compatible avec les VMs Windows ou les plugins Nvidia standard.
  • QXL supporte le multi-écran et une mémoire vidéo configurable.

Options avancées​

Développez cette section pour voir les conseils sur les options plus avancées

Passez à la Vue Avancée sur la page Ajouter une VM pour accéder à des paramètres supplémentaires.

Voici les options avancées les plus importantes, divisées en sections spécifiques :

Mode CPU :

  • Passage de l'hôte : Expose toutes les caractéristiques du CPU hôte à la VM pour des performances maximales.
  • Émulation : Utilise un modèle CPU générique, réduisant les problèmes de compatibilité mais limitant les performances.

Ballon de mémoire :

Type de machine :

  • i440fx: Default for Windows VMs. Change only if you have GPU passthrough issues.
  • Q35 : Par défaut pour les VMs Linux et recommandé pour la plupart des systèmes d'exploitation modernes, surtout avec GPU passthrough.

Type de BIOS :

  • SeaBIOS : BIOS traditionnel pour les OSes hérités.

  • OVMF : BIOS UEFI requis pour Windows 8+, la plupart des distributions Linux modernes, et GPU passthrough.

    note

    Le type de BIOS ne peut être défini qu'à la création d'un nouveau VM.

    Extensions Hyper-V :

  • Pour les VMs Windows, activez les extensions Hyper-V pour améliorer la compatibilité et les performances.

Iso pilotes VirtIO :

  • Remplacez l'ISO VirtIO par défaut si nécessaire, surtout pour tester ou utiliser des pilotes plus récents.

Type de vDisk :

  • RAW : Meilleures performances, moins flexible pour les instantanés.
  • QCOW2 : Supporte les instantanés mais offre une performance légèrement inférieure.

Mappages VirtFS (VMs Linux) :

  • Ajoutez plusieurs partages VirtFS (9p) pour l'intégration du système de fichiers entre l'hôte et l'invité.
  • Voir la documentation QEMU 9p pour plus de détails.

Paramètres réseau :

  • Modifiez l'adresse MAC du réseau ou sélectionnez un pont réseau alternatif.
  • Cliquez sur le symbole de rafraîchissement pour générer automatiquement une nouvelle adresse MAC.
  • Ajoutez des interfaces réseau virtuelles supplémentaires selon besoin.
Troubleshooting conseils
  • Si votre VM ne démarre pas, vérifiez vos chemins ISO et vDisk.
  • Pour GPU passthrough, assurez-vous que votre matériel et vos paramètres BIOS prennent en charge IOMMU/VT-d/AMD-Vi.
  • Certains périphériques USB peuvent ne pas fonctionner de manière fiable avec le passage - testez et consultez les forums Unraid pour des conseils spécifiques aux périphériques.

Attachement des appareils PCI pour le passage​

Avant de pouvoir attribuer un GPU ou n'importe quel dispositif PCI à une machine virtuelle, il est important de "lier" le périphérique au pilote vfio-pci. Ce processus cache le périphérique à Unraid et le consacre uniquement à votre VM.

Pour lier un dispositif PCI (GPU, contrôleur USB, NVMe, etc.) pour le passage :

  1. Naviguez vers Outils → Périphériques système dans le WebGUI.
  2. Passez en revue la liste de tous les appareils PCI détectés et leurs groupes IOMMU.
  3. Cochez la case à côté de chaque appareil que vous souhaitez lier à vfio-pci (pour le masquer d'Unraid).
    • Notez que les appareils déjà utilisés par Unraid (tels que les contrôleurs de disque et les cartes réseau) ne peuvent pas être sélectionnés.
    • Si vous sélectionnez un GPU, choisissez le périphérique sonore associé.
  4. Cliquez sur Lier les sélectionnés à VFIO au démarrage pour sauvegarder vos modifications.
  5. Redémarrez votre serveur pour que le lien prenne effet.
précaution

Si vous effectuez des modifications matérielles (comme ajouter ou retirer des dispositifs PCI), retournez dans Périphériques Système pour vous assurer que les dispositifs corrects sont toujours liés. Si les dispositifs ne sont pas liés ou sont mal liés, ils peuvent ne pas apparaître pour le passage.

Après liaison, les appareils liés apparaîtront dans le menu déroulant Autres Périphériques PCI lors de l'édition ou de la création d'une VM.

Dépannage
  • Si vous avez précédemment utilisé le plugin VFIO-PCI Config, désinstallez-le - cette fonctionnalité est maintenant intégrée.
  • Pour réinitialiser toutes les liaisons, supprimez /boot/config/vfio-pci.cfg et redémarrez votre système.
  • Après redémarrage, utilisez le bouton Voir le journal VFIO-PCI sur la page des Périphériques système pour un dépannage avancé.
  • N'oubliez pas que si vous liez votre seul GPU, Unraid pourrait ne pas démarrer en mode GUI. Assurez-vous de prévoir cela.
  • Pour plus d'informations, consultez le guide officiel sur les forums Unraid.

Passerelle GPU pour machines virtuelles​

Le GPU passthrough vous permet d'assigner une carte graphique physique directement à une machine virtuelle (VM), offrant des performances quasi-native pour les jeux, le travail créatif ou l'apprentissage automatisé.

Why utiliser la transmission directe du GPU?
  • Performance : Accès direct au matériel pour des applications exigeantes.
  • Compatibilité : Exécutez des charges de travail intensives en graphique nécessitant une carte graphique dédiée.
  • Flexibilité : Transformez votre serveur Unraid en un poste de travail polyvalent.

Prérequis

Matériel :

  • CPU supportant Intel VT-d ou AMD-Vi (IOMMU activé dans le BIOS).
  • GPU compatible avec le passage (voir matériel testé par la communauté).
  • Une carte mère qui isole correctement les périphériques PCIe.

Logiciel :

  • Unraid 6.9+ avec la virtualisation activée.
  • Le BIOS OVMF (UEFI) est recommandé pour les VM sur SeaBIOS).

Pour configurer la transmission directe du GPU :

  1. Assurez-vous que votre matériel prend en charge IOMMU et est activé dans votre BIOS.
  2. Activez les fonctionnalités de virtualisation dans le BIOS (Intel VT-x/VT-d ou AMD-v/AMD-vi).
  3. Mettez à jour Unraid à la dernière version stable.
  4. Attribuez la carte graphique à la VM lors de la création ou de l'édition depuis l'écran sous la section carte graphique.
  5. Assignez un clavier et une souris USB au VM si vous utilisez le GPU passthrough.
  6. Utilisez le BIOS OVMF pour le VM pour une meilleure compatibilité avec le GPU passthrough.
  7. Démarrez la VM et vérifiez que le GPU est bien passé.
note

Certaines cartes graphiques peuvent nécessiter une configuration supplémentaire ou une injection ROM pour un passage correct.

Injection ROM manuelle​

Certaines GPU, en particulier certains modèles NVIDIA, nécessitent qu'un fichier ROM soit manuellement fourni à la VM pour s'initialiser correctement. Cela est souvent nécessaire lorsque le firmware embarqué du GPU n'est pas correctement transmis par défaut, causant des problèmes comme des écrans noirs ou des échecs de démarrage. L'injection manuelle de ROM est un dernier recours après avoir essayé des ajustements de BIOS et de configuration VM.

Pour injecter un ROM :

  1. Télécharger le ROM de la carte graphique :

    • Visitez la base de données VGA BIOS de TechPowerUp.
    • Recherchez le modèle de votre carte graphique et téléchargez le fichier ROM correct.
    • Stockez la rom dans votre partage isos ou domains sur Unraid.

  2. Éditez le VM XML :

    • Arrêtez la VM et ouvrez sa configuration XML (Éditer l'XML depuis le menu contextuel de la VM).

    • Localisez le bloc <hostdev> du GPU et ajoutez le tag <rom> :


      <hostdev mode='subsystem' type='pci' managed='yes'>
        <driver name='vfio'/>
        <source>
          <address domain='0x0000' bus='0x02' slot='0x00' function='0x0'/>
        </source>
        <rom file='/mnt/user/isos/gpu_roms/your_gpu.rom'/> <!-- Mettre à jour le chemin -->
        <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x0'/>
      </hostdev>

  3. Enregistrez et testez : Cliquez sur Mettre à jour et démarrez la VM.

Problèmes courants​

Cette section aborde les sujets avancés et les solutions pour les problèmes courants lors de la gestion des machines virtuelles (VMs) sur Unraid. Déroulez les sections ci-dessous pour des instructions étape par étape et des conseils de dépannage.

Agrandir un vDisk​

Cliquez pour étendre/réduire

Si votre VM manque d'espace disque, vous pouvez augmenter la taille de son %%disque virtuel (vDisk)|vdisk directement depuis le %%WebGUI.

Pour agrandir un vDisk :

  1. Allez à l'onglet VMs dans le WebGUI.
  2. Assurez-vous que la VM est arrêtée.
  3. Cliquez sur le nom de la VM pour développer ses détails.
  4. Localisez le vDisk que vous souhaitez agrandir. Cliquez sur la valeur dans le champ Capacité pour la rendre modifiable.
  5. Entrez la nouvelle taille souhaitée (par exemple, 100G pour 100 gigaoctets) et appuyez sur Entrer.
  6. La nouvelle capacité est maintenant définie.
note

Vous ne pouvez pas réduire un vDisk depuis l'interface Unraid ; seule l'expansion est prise en charge.

Extension de la partition dans votre système d'exploitation invité

Après avoir redimensionné le vDisk, démarrez votre VM. Vous devrez étendre la partition dans le système d'exploitation invité pour utiliser le nouvel espace.

  • Windows : Utilisez l'outil intégré de gestion des disques pour étendre votre partition.

  • Linux (LVM) : Utilisez des outils comme fdisk, pvresize, lvextend, et resize2fs pour étendre les partitions et volumes logiques.

    Exemple :

    sudo fdisk /dev/vda
    sudo pvresize /dev/vda3
    sudo lvextend -l +100%FREE /dev/mapper/ubuntu--vg-ubuntu--lv
    sudo resize2fs /dev/mapper/ubuntu--vg-ubuntu--lv

    Ajustez les noms de périphériques selon vos besoins.

    astuce

    Sauvegardez toujours votre VM avant de faire des modifications de disque.

Bloqué à l'UEFI shell​

Cliquez pour étendre/réduire

Si votre VM démarre sur un UEFI shell au lieu de votre système d'exploitation, vous pouvez démarrer le processus de démarrage manuellement :

À l'invite de commande du UEFI shell, entrez :

fs0:
cd efi/boot
bootx64.efi

La VM devrait maintenant continuer à démarrer dans votre système d'exploitation.

astuce

Si cela se produit fréquemment, vérifiez l'ordre de démarrage de votre VM et assurez-vous que le vDisk ou l'ISO correct est défini comme périphérique de démarrage principal dans les paramètres de la VM.

Écran noir après le démarrage de la VM​

Cliquez pour étendre/réduire

Si votre VM démarre mais que l'écran reste vide :

  1. Vérifiez les paramètres BIOS :

    • Réglez la carte graphique principale sur le GPU intégré (iGPU), pas sur le GPU de passage.
    • Mettez à jour le BIOS de la carte mère et de la carte graphique aux dernières versions.

  2. Ajustez les paramètres de la VM :

    • Passez de SeaBIOS à OVMF (UEFI) dans les paramètres de la VM.
    • Changez Type de Machine de i440fx à Q35.

  3. Injection ROM manuelle (dernier recours) : Injectez un ROM GPU manuellement.

Erreur : "Impossible de définir IOMMU pour container : opération non autorisée"​

Cliquez pour étendre/réduire

Cette erreur indique généralement des conflits de groupe IOMMU ou un manque de remappage d'interruptions :

  1. Activer le remplacement PCIe ACS :

    • Allez à Paramètres → Gestionnaire de VMs.
    • Réglez remplacement PCIe ACS sur Downstream ou Both.
    • Redémarrez Unraid.

  2. Autoriser les interruptions non sécurisées (avancé) :

    • Éditez syslinux.cfg sur votre clé USB Unraid :

      append vfio_iommu_type1.allow_unsafe_interrupts=1 initrd=/bzroot

    • Utilisez ceci uniquement si vous faites entièrement confiance à vos invités VM.

note

Pour des explications détaillées sur les groupes IOMMU, consultez le blog d'Alex Williamson.