Passer au contenu principal

Conversion et migration de VM

Lorsque vous consolidez du matériel, préservez des systèmes hérités ou testez des mises à niveau dans un environnement virtuel, vous pouvez avoir besoin de convertir un disque physique ou de migrer un système existant vers une machine virtuelle sur Unraid. Ce processus s'applique aux systèmes Linux et Windows, vous permettant d'exécuter votre installation en tant que VM au sein de votre serveur Unraid.

:::note[Prerequisites]

  • Votre serveur Unraid doit répondre aux exigences matérielles minimales pour la virtualisation (voir tableau ci-dessous).
  • Le disque source doit être connecté à votre serveur Unraid (via SATA, USB ou comme périphérique non assigné).
  • Assurez-vous d'avoir suffisamment d'espace libre dans votre array ou cache pool pour accueillir la nouvelle image de disque virtuel.
  • Sauvegardez toutes les données critiques avant de démarrer le processus de conversion ou de migration.

:::

Exigences matérielles​

ComposantExigence minimaleRecommandé pour de meilleures performances
Processeur64 bits avec virtualisation matérielle (Intel VT-X/AMD-V)Processeur multicœur avec VT-d/AMD-Vi pour le passage direct
RAM8 Go16 Go ou plus
StockageUn pool de cache SSD ou NVMe cache pool avec espace suffisantUn pool de cache NVMe dédié cache pool pour le stockage VM
Carte mère/BIOSUEFI avec virtualisation activéeUEFI avec IOMMU/VT-d/AMD-Vi activé

Convertir un disque physique en VM​

Migrer un système Linux ou Windows existant vers une machine virtuelle sur votre serveur Unraid peut être un excellent moyen de gagner de l'espace matériel, de maintenir les systèmes hérités en fonctionnement ou de tester de nouvelles mises à niveau en toute sécurité.

Pour convertir un disque physique en VM :

Étape 1 : Préparer le disque physique

  1. Connectez le disque source à votre serveur Unraid (en utilisant SATA ou USB).
  2. Connectez-vous au WebGUI (http://tower ou http://tower.local).
  3. Cliquez sur l'onglet Principal.
  4. Démarrez l'array s'il n'est pas déjà en cours d'exécution.
  5. Trouvez votre disque sous Périphériques non assignés.
  6. Take note of the device letter (e.g., sdb, sdc) and disk size. You’ll need at least this free space on your array or cache pool for the new virtual disk.

Étape 2 : Créer une nouvelle machine virtuelle

Référez-vous au guide Créer vos propres machines virtuelles, avec les exceptions suivantes :

Étape 3 : Convertir le disque physique en image de disque virtuel

Ouvrez un terminal (SSH ou console locale) et connectez-vous en tant que root.

Utilisez la commande suivante pour convertir le disque physique en image de disque virtuel :

qemu-img convert -p -O raw /dev/sdX /mnt/user/[vdisk_share]/[vmname]/vdisk1.img
  • /dev/sdX : Remplacez par la lettre du périphérique de l'étape 1 (ex. : /dev/sdb)
  • [vdisk_share] : Le partage où vous enregistrez vos images VM
  • [vmname] : Le nom que vous souhaitez pour votre VM

Décomposition de la commande :

  • qemu-img convert : Cet outil est utilisé pour la conversion d'images disque.
  • -p : Affiche la progression en pourcentage.
  • -O raw : Définit le format de sortie sur brut (par défaut Unraid).
  • /dev/sdX : La source correspond à votre disque physique.
  • /mnt/user/[vdisk_share]/[vmname]/vdisk1.img : Destination pour l'image disque virtuel.

Attendez que l'opération soit terminée. Le fichier .img résultant sera le disque principal pour votre VM.

Migration d'un disque physique vers une VM​

Vous pouvez exécuter une installation Windows directement à partir d'un disque physique dans une machine virtuelle (VM) Unraid. Cette méthode aide à migrer un système Windows existant sans le convertir en une image de disque virtuel. Pour un guide visuel, consultez le tutoriel de Spaceinvader One :
How to pass through hard drives, convert disks, and test performance in Unraid VMs (YouTube).

Choosing votre approche de migration

Il existe deux méthodes courantes pour migrer une installation Windows vers une VM sur Unraid :

Pass-through de disque physique : utilise le disque original directement dans la VM.

  • Avantages : Méthode la plus rapide, pas besoin de conversion d'image.
  • Inconvénients : Prend un port SATA ; Unraid ne peut pas utiliser le disque à d'autres fins lorsqu'il est attaché à la VM.

Conversion d'image de disque : convertit le disque physique en image de disque virtuel (.img) à utiliser dans la VM.

  • Avantages : Plus de flexibilité, permet d'utiliser le disque comme partage Unraid ou pour les snapshots.
  • Inconvénients : Nécessite du temps et de l'espace libre pour le processus de conversion.

Choisissez le « passthrough » si vous souhaitez une migration simple ou envisagez de démarrer en double sur le disque. Optez pour la conversion d'image pour une meilleure portabilité et des options de sauvegarde.

:::note[Prerequisites]

  • Sauvegardez votre installation Windows avant de commencer.
  • Ayez une clé USB de rechange prête pour les outils de récupération.
  • Sélectionnez un outil de préparation matérielle qui permet à Windows de démarrer sur un matériel virtualisé en modifiant les pilotes et la couche d'abstraction matérielle (HAL) :
    • Microsoft Sysprep (gratuit et intégré dans Windows 8.1 et versions ultérieures)
    • Acronis True Image 2025 (solution commerciale avec des fonctionnalités avancées de migration)
  • Assurez-vous que votre serveur Unraid dispose d'un port SATA ou NVMe libre pour le disque physique.

:::

Étape 1 : Préparer le disque Windows pour la migration

Déplacer une installation de Windows vers un nouveau matériel, qu'il soit physique ou virtuel, peut entraîner des échecs de démarrage en raison des différences matérielles. Suivez l'une des méthodes ci-dessous pour préparer votre système Windows :

Option A : Microsoft sysprep (recommandé - gratuit)

Sysprep est intégré à Windows et élimine les informations système uniques, préparant Windows pour un matériel différent.

Before exécution de sysprep
  • Désactivez temporairement tout logiciel antivirus.
  • Nettoyez les profils utilisateurs et fichiers temporaires inutiles.
  • Corrigez ou supprimez toute application problématique du Microsoft Store pouvant empêcher l'exécution de sysprep.

  1. Exécuter sysprep :

    • Ouvrir l'Invite de commandes en tant qu'administrateur.

    • Accédez au répertoire sysprep :

      cd C:\Windows\System32\Sysprep

    • Exécutez sysprep avec généralisation :

      sysprep.exe /generalize /shutdown /oobe

    • Le système généralisera l'installation puis s'éteindra.

  2. Installez le disque dans votre serveur Unraid après l'arrêt.

Option B : Acronis True Image 2025 (commercial)

Acronis True Image 2025 inclut Universal Restore, qui assiste la migration matérielle.

  1. Téléchargez et installez Acronis True Image 2025.
  2. Créez un média de récupération amorçable en utilisant les outils inclus :
    • Choisissez l'interface de type Windows.
    • Sélectionnez l'architecture qui correspond à votre Windows (32 bits ou 64 bits).
  3. Démarrez votre système Windows depuis le support de récupération Acronis.
  4. Suivez les instructions à l'écran pour appliquer Universal Restore à votre disque Windows. Cela mettra à jour les pilotes et le HAL pour une meilleure compatibilité avec le matériel virtualisé.
  5. Arrêtez le système et installez le disque dans votre serveur Unraid.

Étape 2 : Identifier le disque physique dans Unraid

  1. Connectez-vous au WebGUI (http://tower ou http://tower.local).
  2. Allez dans l'onglet Principal.
  3. Démarrez l'array s'il n'est pas déjà en cours d'exécution.
  4. Localisez votre disque sous Périphériques non assignés.
  5. Notez la lettre du périphérique (par exemple, sdb, sdc) pour l'utiliser dans la configuration VM.

Étape 3 : Créer une nouvelle machine virtuelle

  1. Allez dans l'onglet VMs dans le WebGUI. Si l'onglet est manquant, assurez-vous que la virtualisation est activée et que les exigences matérielles sont remplies.
  2. Cliquez sur Ajouter une VM.
  3. Suivez le guide Créer vos propres machines virtuelles, en utilisant ces paramètres :
    • Réglez le BIOS sur SeaBIOS (essayez OVMF si SeaBIOS échoue à démarrer).
    • Laissez OS Install ISO vide.
    • Spécifiez le VirtIO Drivers ISO pour des performances optimales après le démarrage.
    • Pour le disque virtuel principal, sélectionnez n'importe quel emplacement et taille (cela sera remplacé à l'étape suivante).
    • Décochez Start VM after creation.

Étape 4 : Modifiez le XML de votre machine virtuelle

Vous devez modifier la configuration XML du VM pour connecter votre disque physique à la machine virtuelle.

  1. Depuis l'onglet VMs, cliquez sur l'icône VM, puis sélectionnez Edit XML dans le menu contextuel.

  2. Défilez vers le bas dans l'XML et trouvez l'entrée <disk> existante pour votre disque virtuel principal. Cela pointe généralement vers un fichier .img et ressemblera à ceci :


    <disk type='file' device='disk'>
    <driver name='qemu' type='raw' cache='writeback'/>
    <source file='/mnt/cache/vdisk_share/vmname/vdisk1.img'/>
    <backingStore/>
    <target dev='hda' bus='virtio'/>
    <boot order='1'/>
    <alias name='virtio-disk0'/>
    <address type='pci' domain='0x0000' bus='0x00' slot='0x05' function='0x0'/>
    </disk>

    Remplacez ce bloc par ce qui suit, où sdX est la lettre du périphérique ou, mieux encore, utilisez /dev/disk/by-id/[votre-id-disque] pour une attribution de périphérique plus fiable (consultez le [Unraid Docs : Utilisation d'un disque physique dans une VM]) :


    <disk type='block' device='disk'>
    <driver name='qemu' type='raw' cache='writeback'/>
    <source dev='/dev/disk/by-id/[your-disk-id]'/>
    <target dev='hdd' bus='sata'/>
    </disk>

    Si votre disque est IDE, changez le bus de "SATA" à "IDE".

    L'utilisation de /dev/disk/by-id/ est préférable à /dev/sdX pour s'assurer que l'attribution du disque reste cohérente après les redémarrages ou les changements matériels.

  3. Cliquez sur Update pour enregistrer vos modifications XML.

Étape 5 : Installer les pilotes

  1. Démarrez votre VM.
  2. Une fois sous Windows, ouvrez le Gestionnaire de périphériques en cliquant avec le bouton droit sur le menu Démarrer et en sélectionnant Device Manager.
  3. Recherchez les périphériques marqués d'un point d'exclamation jaune (indiquant des pilotes manquants). Cliquez droit sur chacun et sélectionnez Mettre à jour le pilote.
  4. Choisissez Browse my computer for drivers.
  5. Indiquez le disque où l'ISO des pilotes VirtIO est monté (habituellement D: ou E:).
  6. Assurez-vous que Include subfolders est coché, puis cliquez sur Next.
  7. Répétez ce processus pour chaque appareil avec des pilotes manquants, comprenant généralement : Contrôleur SCSI, Ethernet, Balloon et périphériques série.

N'oubliez pas de réinstaller ces applications après la migration si vous utilisez des logiciels qui installent leurs propres pilotes (comme les programmes antivirus).

astuce

Si vous êtes bloqué à SeaBIOS avec un message "Démarrage depuis le disque dur", c'est probablement parce que votre OS Windows a été installé en utilisant UEFI au lieu du BIOS traditionnel. Dans ce cas, recréez la VM en utilisant OVMF comme type de BIOS plutôt que SeaBIOS. La plupart des installations modernes de Windows (Windows 8.1, 10 et 11) supportent UEFI et peuvent avoir besoin de OVMF pour démarrer avec succès. Le reste du processus de conversion restera le même.

Migration de Xen vers KVM​

Historical Contexte

Unraid a pris en charge Xen depuis les versions 6.x précoces jusqu'à ce qu'il soit déprécié dans la version 6.2 (septembre 2016) et retiré entièrement par la suite. Ce guide de migration est pertinent pour les utilisateurs mettant à niveau des installations Unraid très anciennes (avant 2017) vers des versions modernes.

Un hyperviseur Xen est une plateforme de virtualisation qui permet à plusieurs systèmes d'exploitation de fonctionner sur le même matériel. Dans Unraid, Xen était historiquement utilisé pour les machines virtuelles, mais KVM est désormais la norme. La migration de Xen vers KVM est essentielle pour utiliser les fonctionnalités modernes d'Unraid, permettre le passage direct de matériel, et assurer la compatibilité avec les versions actuelles.

Le processus de migration d'un VM de Xen à KVM varie selon que votre VM est configuré comme un invité paravirtualisé (PV) ou virtualisé matériellement (HVM). Ce guide se concentre spécifiquement sur la conversion des VM Windows utilisant les pilotes GPLPV de Xen, car ils nécessitent une gestion particulière.

Créez toujours une sauvegarde de votre disque virtuel Xen avant de commencer ce processus. Et testez votre migration sur la sauvegarde pour éviter toute perte de données.

Why migrer?

Unraid ne prend plus en charge Xen à partir de la version 6.2. KVM est maintenant obligatoire pour la gestion des VM, le passage direct du matériel, et les mises à jour continues. La migration garantit que vos VM restent sécurisées et compatibles avec les nouvelles fonctionnalités.

Procédure de conversion Windows​

Pour convertir une VM Windows de Xen à KVM, suivez ces étapes. N'oubliez pas de retirer tout passage direct de périphérique PCI de votre configuration de domaine Xen avant de commencer. Ces périphériques pourront être ajoutés de nouveau après la migration.

Étape 1 : Déterminez si votre VM utilise les pilotes GPLPV de Xen - Cliquer pour développer/réduire
  1. À l'intérieur de votre VM Xen, ouvrez le Gestionnaire de périphériques Windows (appuyez sur Touche Windows + X, puis sélectionnez Device Manager).
  2. Développez Carte réseau et vérifiez le nom de l'appareil.
    • Si le nom contient "Xen," vous utilisez des pilotes GPLPV.
    • Si ce n'est pas le cas, passez à l'étape concernant le redémarrage en mode KVM.
astuce

Si vous n'utilisez pas les pilotes GPLPV, vous pouvez sauter les prochaines étapes et continuer à partir de la section de redémarrage en mode KVM.

Étape 2 : Préparez Windows pour la suppression des pilotes GPLPV - Cliquer pour développer/réduire
  1. Ouvrez une invite de commande en tant qu'Administrateur (Menu Démarrer → tapez cmd → clic droit sur Invite de commandes → sélectionnez Exécuter en tant qu'administrateur).
  2. Entrez la commande suivante : 
    bcdedit -set loadoptions nogplpv
  3. Redémarrez votre VM.
Étape 1 : Déterminez si votre VM utilise les pilotes GPLPV de Xen - Cliquer pour développer/réduire

Après le redémarrage, purgez tous les pilotes GPLPV de Xen de votre système en utilisant le processus complet de suppression manuelle documenté dans le Wiki du projet Xen.

astuce

Si vous n'utilisez pas les pilotes GPLPV, vous pouvez sauter les prochaines étapes et continuer à partir de la section de redémarrage en mode KVM.

Étape 2 : Préparez Windows pour la suppression des pilotes GPLPV - Cliquer pour développer/réduire

  1. Assurez-vous que le gestionnaire de VM est activé :

    • Allez sur Settings → VM manager.
    • Réglez Enable VMs sur Oui.
    • Téléchargez le dernier ISO des pilotes VirtIO pour Windows en le sélectionnant dans le menu déroulant et en cliquant sur Télécharger.

  2. Accédez à l'onglet VMs et cliquez sur Add VM.

  3. Sélectionnez la version Windows qui correspond à votre machine virtuelle Xen d'origine.

  4. Configurez les paramètres de base :

    • Nom : Attribuez un nom descriptif à votre VM.
    • ISO des pilotes VirtIO : Choisissez la version que vous venez de télécharger.

  5. Sous Primary vDisk Location :

    • Parcourez et sélectionnez votre disque virtuel Xen existant.

  6. Ajoutez un Secondary vDisk temporaire :

    • Cliquez sur le signe plus vert.
    • Réglez la taille à 1M (cela imposera la compatibilité du bus IDE lors du démarrage initial).
    • Choisissez n'importe quel répertoire temporaire pour l'emplacement (cela sera supprimé plus tard).

  7. Laissez les autres paramètres pour les graphismes et le son à leurs valeurs par défaut, puis cliquez sur Créer.

  8. Forcez l'arrêt immédiat de la VM :

    • Cliquez sur l'icône de la VM et choisissez Force stop.

  9. Modifiez la configuration de la VM :

    • Cliquez sur l'icône de la VM et sélectionnez Edit.
    • Passez à la vue XML en utilisant le basculement en haut à droite.

  10. Modifiez le XML du disque principal :

    • Localisez la section <disk> pour votre disque virtuel principal.
    • Supprimez la ligne entière <address>.
    • Remplacez bus='virtio' par bus='ide' dans la balise <target>.
    • Cliquez sur Update.
Pourquoi le disque temporaire ?

Le disque temporaire de 1 Mo force Unraid à assigner le disque principal comme hda (IDE) au lieu de vda (VirtIO), permettant à Windows de démarrer sans pilotes VirtIO au départ. Ce disque temporaire sera supprimé après l'installation du pilote.

Étape 5 : Installez les pilotes VirtIO - Cliquer pour développer/réduire
  1. Démarrez la VM depuis l'onglet VMs.
  2. Connectez-vous via VNC en cliquant sur l'icône de la VM et sélectionnez Start with console (VNC).
  3. Pendant le démarrage :
    • Windows détectera un nouveau matériel mais pourrait échouer à installer les pilotes.
    • Choisissez Reboot later lorsque cela est demandé.
  4. Ouvrez le Gestionnaire de périphériques (appuyez sur Win+X et choisissez Gestionnaire de périphériques) :
    • Installez les pilotes pour chaque appareil répertorié sous Autres périphériques (comme le Contrôleur Ethernet, le Périphérique PCI, etc.) :
      1. Cliquez avec le bouton droit sur le périphérique et sélectionnez Update driver.
      2. Choisissez Browse my computer for drivers.
      3. Indiquez le lecteur VirtIO ISO (par exemple, D:\).
      4. Cochez Include subfolders.
      5. Si demandé, acceptez toujours Always trust Red Hat.
  5. Installez l'agent QEMU guest agent :
    • Ouvrez l'Explorateur de fichiers et accédez à D:\guest-agent\.
    • Double-cliquez sur qemu-ga-x64.msi.
  6. Éteignez la VM.
Étape 4 : Créer une nouvelle machine virtuelle KVM - Cliquer pour développer/réduire
  1. Modifiez la VM :
    • Supprimez le vDisk secondaire temporaire en cliquant sur l'icône rouge moins.
    • Confirmez que le vDisk principal pointe vers votre disque Xen d'origine.
  2. Mettez à jour la VM :
    • Cliquez sur Update pour enregistrer vos modifications.
  3. Démarrez la VM normalement.
  4. Vérifiez dans le Gestionnaire de périphériques que :
    • Aucune icône d'avertissement n'apparaît.
    • Tous les périphériques utilisent les pilotes VirtIO (par exemple, "Adaptateur Ethernet VirtIO Red Hat").
  5. (Optionnel) Activez VirtIO pour de meilleures performances :
    • Modifiez la VM et passez à la vue XML.
    • Changez l'bus du disque principal de ide à virtio.
    • Cliquez sur Update et redémarrez la VM.
Pourquoi le disque temporaire ?

Le disque temporaire de 1 Mo force Unraid à assigner le disque principal comme hda (IDE) au lieu de vda (VirtIO), permettant à Windows de démarrer sans pilotes VirtIO au départ. Ce disque temporaire sera supprimé après l'installation du pilote.

  1. Réinstallez les pilotes VirtIO depuis l'ISO.
  2. Vérifiez les mises à jour Windows, qui peuvent fournir des pilotes plus récents.
  3. Visitez la page Red Hat VirtIO Drivers pour les dernières versions. :::