Zum Hauptinhalt springen

VM-Konvertierung und Migration

Bei der Konsolidierung von Hardware, der Sicherung älterer Systeme oder dem Testen von Upgrades in einer virtuellen Umgebung müssen Sie möglicherweise eine physische Festplatte in eine virtuelle Maschine auf Unraid konvertieren oder ein bestehendes System migrieren. Dieser Prozess gilt sowohl für Linux- als auch für Windows-Systeme, sodass Sie Ihre Installation als VM innerhalb Ihres Unraid-Servers ausführen können.

:::note[Prerequisites]

  • Ihr Unraid-Server sollte die Mindestanforderungen an die Hardware für die Virtualisierung (siehe Tabelle unten) erfüllen.
  • Die Quellfestplatte muss an Ihren Unraid-Server angeschlossen sein (über SATA, USB oder als nicht zugewiesenes Gerät).
  • Ensure you have enough free space in your array or cache pool to accommodate the new virtual disk image.
  • Sichern Sie alle wichtigen Daten, bevor Sie mit dem Konvertierungs- oder Migrationsprozess beginnen.

:::

Hardwareanforderungen​

KomponenteMindestanforderungEmpfohlen für beste Leistung
CPU64-Bit mit Hardware-Virtualisierung (Intel VT-X/AMD-V)Multi-Core-CPU mit VT-d/AMD-Vi für Passthrough
RAM8 GB16 GB oder mehr
SpeicherSSD- oder NVMe-cache pool mit ausreichend PlatzDedicated NVMe cache pool for VM storage
Motherboard/BIOSUEFI mit aktivierter VirtualisierungUEFI mit aktivierten IOMMU/VT-d/AMD-Vi

Eine physische Festplatte in eine VM konvertieren​

Das Migrieren eines bestehenden Linux- oder Windows-Systems in eine virtuelle Maschine auf Ihrem Unraid-Server kann eine großartige Möglichkeit sein, Hardware zu sparen, Altsysteme am Laufen zu halten oder neue Upgrades sicher zu testen.

So konvertieren Sie eine physische Festplatte in eine VM:

Schritt 1: Bereiten Sie die physische Festplatte vor

  1. Verbinden Sie die Quellfestplatte mit Ihrem Unraid-Server (über SATA oder USB).
  2. Gehen Sie zum VMs-Tab im WebGUI. Falls der Tab fehlt, überprüfen Sie, ob die Virtualisierung aktiviert wurde und die Hardwareanforderungen erfüllt sind.
  3. Klicken Sie auf die Registerkarte Haupt.
  4. Starten Sie das array, falls es noch nicht läuft.
  5. Finden Sie Ihre Festplatte unter Nicht zugewiesene Geräte.
  6. Notieren Sie sich den Gerätebuchstaben (z. B. sdb, sdc) und die Festplattengröße. Sie benötigen mindestens diesen freien Platz auf Ihrem array oder cache pool für das neue virtual disk.

Schritt 2: Erstellen Sie eine neue virtuelle Maschine

Lesen Sie den Leitfaden zum Erstellen Ihrer eigenen virtuellen Maschinen mit den folgenden Ausnahmen:

Schritt 3: Konvertieren Sie die physische Festplatte in ein virtuelles Festplatten-Image

Öffnen Sie ein Terminal (SSH oder lokale Konsole) und melden Sie sich als root an.

Verwenden Sie den folgenden Befehl, um die physische Festplatte in ein virtuelles Festplatten-Image zu konvertieren:

qemu-img convert -p -O raw /dev/sdX /mnt/user/[vdisk_share]/[vmname]/vdisk1.img
  • /dev/sdX: Ersetzen Sie durch den Gerätebuchstaben aus Schritt 1 (z. B. /dev/sdb)
  • [vdisk_share]: Die Freigabe, in der Sie Ihre VM-Images speichern
  • [vmname]: Der Name, den Sie für Ihre VM möchten

Befehlsübersicht:

  • qemu-img convert: Dieses Tool wird zur Konvertierung von Festplatten-Images verwendet.
  • -p: Zeigt den Fortschritt als Prozentsatz an.
  • -O raw: Sets the output format to raw (Unraid's default).
  • /dev/sdX: Quelle ist Ihre physische Festplatte.
  • /mnt/user/[vdisk_share]/[vmname]/vdisk1.img: Ziel für das virtuelle Festplatten-Image.

Warten Sie, bis der Vorgang abgeschlossen ist. Die resultierende .img-Datei wird die primäre Festplatte für Ihre VM sein.

Migration einer physischen Festplatte zu einer VM​

Sie können eine Windows-Installation direkt von einer physischen Festplatte in einer Unraid-virtuellen Maschine (VM) ausführen. Diese Methode hilft, ein bestehendes Windows-System zu migrieren, ohne es in ein virtuelles Festplattenabbild zu konvertieren. Eine visuelle Anleitung finden Sie im Tutorial von Spaceinvader One:
Wie man Festplatten durchreicht, Disketten konvertiert und die Leistung in Unraid VMs testet (YouTube).

Choosing Ihr Migrationsansatz

Es gibt zwei gängige Methoden, um eine Windows-Installation in eine VM in Unraid zu migrieren:

Physikalischer Festplattendurchlauf: Verwendet die Originalfestplatte direkt in der VM.

  • Vorteile: Schnellste Methode, keine Bildkonvertierung erforderlich.
  • Nachteile: Belegt einen SATA-Port; Unraid kann die Festplatte nicht für andere Zwecke verwenden, wenn sie der VM angehängt ist.

Disk-Image-Konvertierung: Dies konvertiert die physische Festplatte in ein virtuelles Festplatten-Image (.img) zur Verwendung in der VM.

  • Vorteile: Mehr Flexibilität, ermöglicht die Verwendung der Festplatte als Unraid-Freigabe oder für VM-Snapshots.
  • Nachteile: Erfordert Zeit und freien Speicherplatz für den Konvertierungsprozess.

Wählen Sie Passthrough, wenn Sie eine einfache Migration wünschen oder planen, die Platte dual zu booten. Entscheiden Sie sich für Image-Konvertierung für bessere Portabilität und Backup-Optionen.

:::note[Prerequisites]

  • Sichern Sie Ihre Windows-Installation, bevor Sie beginnen.
  • Halten Sie einen freien USB-Stick für Wiederherstellungstools bereit.
  • Wählen Sie ein Hardwarevorbereitungstool aus, das es Windows ermöglicht, auf virtualisierter Hardware zu booten, indem es Treiber und die Hardwareabstraktionsschicht (HAL) ändert:
    • Microsoft Sysprep (kostenlos und in Windows 8.1 und später integriert)
    • Acronis True Image 2025 (kommerzielle Lösung mit erweiterten Migrationsfunktionen)
  • Stellen Sie sicher, dass Ihr Unraid-Server einen freien SATA- oder NVMe-Anschluss für die physische Festplatte hat.

:::

Schritt 1: Bereiten Sie die Windows-Festplatte für die Migration vor

Sysprep ist in Windows integriert und eliminiert eindeutige Systeminformationen, um Windows für unterschiedliche Hardware vorzubereiten.

Option A: Microsoft Sysprep (empfohlen - kostenlos)

Sysprep ist in Windows integriert und eliminiert eindeutige Systeminformationen, um Windows für unterschiedliche Hardware vorzubereiten.

:::note[Before [Sysprep ausführen]

  • Sysprep ausführen:
  • Installieren Sie die Festplatte in Ihrem Unraid-Server nach dem Herunterfahren.
  • Beheben Sie problematische Microsoft Store-Anwendungen oder entfernen Sie diese, die verhindern könnten, dass Sysprep ausgeführt wird.

:::

  1. Sysprep ausführen:

    • Öffnen Sie die Eingabeaufforderung als Administrator.

    • Navigieren Sie zum Sysprep-Verzeichnis:

      cd C:\Windows\System32\Sysprep

    • Führen Sie Sysprep mit Generalisierung aus:

      sysprep.exe /generalize /shutdown /oobe

    • Das System wird die Installation generalisieren und dann herunterfahren.

  2. Installieren Sie die Festplatte in Ihrem Unraid-Server nach dem Herunterfahren.

Option B: Acronis True Image 2025 (kommerziell)

Acronis True Image 2025 bietet Universal Restore, das bei der Hardware-Migration hilft.

  1. Melden Sie sich bei der WebGUI (http://tower oder http://tower.local) an.
  2. Gehen Sie zur Registerkarte Haupt.
    • Wählen Sie die Windows-ähnliche Benutzeroberfläche aus.
    • Wählen Sie die Architektur, die zu Ihrem Windows passt (32-Bit oder 64-Bit).
  3. Start the array if it’s not already running.
  4. Finden Sie Ihr Laufwerk unter Nicht zugewiesene Geräte.
  5. Fahren Sie das System herunter und installieren Sie die Festplatte in Ihrem Unraid-Server.

Schritt 2: Identifizieren Sie die physische Festplatte in Unraid

  1. Gehen Sie zum VMs-Tab im WebGUI. Falls der Tab fehlt, überprüfen Sie, ob die Virtualisierung aktiviert wurde und die Hardwareanforderungen erfüllt sind.
  2. Klicken Sie auf VM hinzufügen.
  3. Start the array if it’s not already running.
  4. Finden Sie Ihr Laufwerk unter Nicht zugewiesene Geräte.
  5. Notieren Sie sich den Gerätebuchstaben (zum Beispiel sdb, sdc) für die Einstellung der VM.

Schritt 4: Bearbeiten Sie das XML für Ihre virtuelle Maschine

  1. Gehen Sie zum VMs-Tab im WebGUI. Falls der Tab fehlt, überprüfen Sie, ob die Virtualisierung aktiviert wurde und die Hardwareanforderungen erfüllt sind.
  2. Klicken Sie auf VM hinzufügen.
  3. Befolgen Sie die Anleitungen zum Erstellen eigener virtueller Maschinen mit diesen Einstellungen:
    • Setzen Sie das BIOS auf SeaBIOS (versuchen Sie OVMF, falls SeaBIOS nicht startet).
    • Lassen Sie OS Install ISO leer.
    • Geben Sie die VirtIO-Treiber-ISO an, um nach dem Hochfahren eine optimale Leistung zu erzielen.
    • Wählen Sie für die primäre virtuelle Festplatte einen beliebigen Speicherort und eine Größe aus (dies wird im nächsten Schritt ersetzt).
    • Deaktivieren Sie Start VM nach der Erstellung.

Schritt 4: Bearbeiten Sie das XML für Ihre virtuelle Maschine

Sie müssen die XML-Konfiguration des VM ändern, um Ihre physische Festplatte mit der virtuellen Maschine zu verbinden.

  1. Starten Sie Ihre VM.

  2. Scrollen Sie im XML-Dokument nach unten und finden Sie den bestehenden <disk> Eintrag für Ihre primäre virtuelle Festplatte. Dieser verweist normalerweise auf eine .img Datei und sieht ungefähr so aus:


    <disk type='file' device='disk'>
    <driver name='qemu' type='raw' cache='writeback'/>
    <source file='/mnt/user/[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>

    Ersetzen Sie diesen Block durch den folgenden, wobei sdX der Geräteschreibbuchstabe ist, oder verwenden Sie besser /dev/disk/by-id/[Ihre-Platten-ID] für eine zuverlässigere Gerätzuordnung (siehe [Unraid-Dokumente: Verwendung einer physikalischen Platte in einer 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>

    Falls Ihre Festplatte IDE ist, ändern Sie den Bus von "SATA" zu "IDE" und das Zielgerät von "hdd" zu "hda".

    Die Verwendung von /dev/disk/by-id/ wird gegenüber /dev/sdX bevorzugt, um sicherzustellen, dass die Festplattenzuweisung nach Neustarts oder Hardwareänderungen konsistent bleibt.

  3. Suchen Sie nach Geräten, die mit einem gelben Ausrufezeichen gekennzeichnet sind (fehlende Treiber). Klicken Sie mit der rechten Maustaste auf jedes und wählen Sie Treiber aktualisieren.

Schritt 5: Treiber installieren

  1. Starten Sie Ihre VM.
  2. Sobald Windows gestartet ist, öffnen Sie den Geräte-Manager, indem Sie mit der rechten Maustaste auf das Startmenü klicken und Geräte-Manager auswählen.
  3. Suchen Sie nach Geräten, die mit einem gelben Ausrufezeichen gekennzeichnet sind (fehlende Treiber). Klicken Sie mit der rechten Maustaste auf jedes und wählen Sie Treiber aktualisieren.
  4. Wählen Sie Auf dem Computer nach Treibersoftware suchen.
  5. Weisen Sie es dem Laufwerk zu, auf dem die VirtIO-Treiber-ISO eingehängt ist (normalerweise D: oder E:).
  6. Stellen Sie sicher, dass Unterordner einbeziehen aktiviert ist, und klicken Sie dann auf Weiter.
  7. Wiederholen Sie diesen Vorgang für jedes Gerät ohne Treiber, häufig einschließlich: SCSI-Controller, Ethernet, Balloon und Serielle Geräte.

Denken Sie daran, diese Anwendungen nach der Migration neu zu installieren, falls Sie Software verwenden, die eigene Treiber installiert (wie Antivirus-Programme).

Hinweis

Wenn Sie bei SeaBIOS mit der Nachricht „Booting from Hard Disk“ hängen bleiben, liegt es wahrscheinlich daran, dass Ihr Windows-Betriebssystem mit UEFI anstelle des traditionellen BIOS installiert wurde. In diesem Fall erstellen Sie die VM mit OVMF als BIOS-Typ anstelle von SeaBIOS neu. Die meisten modernen Windows-Installationen (Windows 8.1, 10 und 11) unterstützen UEFI und benötigen möglicherweise OVMF zum Starten. Der Rest des Konvertierungsprozesses bleibt gleich.

Xen zu KVM Migration​

:::info[Historical [Kontext]

Unraid unterstützte Xen von den frühen 6.x-Versionen bis es in Version 6.2 (September 2016) veraltet wurde und später vollständig entfernt wurde. Dieser Migrationsleitfaden ist relevant für Benutzer, die von sehr alten Unraid-Installationen (vor 2017) auf moderne Versionen aktualisieren.

:::

A Xen hypervisor is a virtualization platform that allows multiple operating systems to run on the same hardware. In Unraid, Xen was historically used for virtual machines, but KVM is now the standard. Migrating from Xen to KVM is essential for utilizing modern Unraid features, enabling hardware passthrough, and ensuring compatibility with current releases.

Der Prozess der Migration einer VM von Xen zu KVM variiert je nachdem, ob Ihre VM als paravirtualisierter (PV) oder hardware-virtualisierter (HVM) Gast eingerichtet ist. Dieser Leitfaden konzentriert sich speziell auf die Konvertierung von Windows-VMs, die die GPLPV-Treiber von Xen verwenden, da sie spezielle Handhabung erfordern.

Always create a backup of your Xen virtual disk before starting this process. And test your migration on the backup to prevent data loss.

:::info[Why [Migrieren?]

Unraid unterstützt Xen ab Version 6.2 nicht mehr. KVM ist jetzt zur Verwaltung von virtuellen Maschinen, Hardware-Passthrough und laufenden Updates verpflichtend. Die Migration gewährleistet, dass Ihre virtuellen Maschinen sicher und mit neuen Funktionen kompatibel bleiben.

:::

Verfahren zur Windows-Konvertierung​

To convert a Windows VM from Xen to KVM, follow these steps. Remember to remove any PCI device passthrough from your Xen domain configuration before you begin. These devices can be added back after the migration is complete.

Schritt 5: Installieren Sie die VirtIO-Treiber - Klicken um zu erweitern/einzuklappen
  1. Öffnen Sie innerhalb Ihrer %%Xen|Xen-HVM%% VM den Windows-Geräte-Manager (drücken Sie Windows-Taste + X, dann Geräte-Manager auswählen).
  2. Verbinden Sie sich über VNC, indem Sie auf das VM-Symbol klicken und Start mit Konsole (VNC) auswählen.
    • Wenn der Name "Xen" enthält, verwenden Sie GPLPV-Treiber.
    • Wenn nicht, fahren Sie mit dem Schritt zum Neustart im KVM-Modus fort.
Hinweis

Wenn Sie keine GPLPV-Treiber verwenden, können Sie die nächsten Schritte überspringen und mit dem Abschnitt zum Neustart in den KVM-Modus fortfahren.

Schritt 6: Finalisieren Sie die VM-Konfiguration - Klicken um zu erweitern/einzuklappen
  1. Bearbeiten Sie die VM:
  2. Aktualisieren Sie die VM: 
    bcdedit -set loadoptions nogplpv
  3. Starten Sie die VM normal.
Schritt 3: Deinstallieren Sie die GPLPV-Treiber - Klicken um zu erweitern/einzuklappen

Nach dem Neustart entfernen Sie alle Xen GPLPV-Treiber manuell aus Ihrem System, indem Sie den umfassenden manuellen Entfernungsprozess im Xen Project Wiki dokumentieren.

vorsicht

Das Entfernen der GPLPV erfordert umfangreiche Registrierungsbearbeitungen und das manuelle Löschen von Dateien. Folgen Sie den Anweisungen im Xen Project Wiki genau wie geschrieben, da Fehler zu Systeminstabilität oder Startfehlern führen können.

Schritt 4: Erstellen Sie eine neue KVM-Virtualisierungsmaschine - Klicken um zu erweitern/einzuklappen

  1. Stellen Sie sicher, dass der VM Manager aktiviert ist:

    • Gehen Sie zu Einstellungen → VM Manager.
    • Stellen Sie VMs aktivieren auf Ja.
    • Laden Sie die neuesten VirtIO-Treiber-ISO für Windows herunter, indem Sie sie im Dropdown-Menü auswählen und auf Download klicken.

  2. Navigieren Sie zum Tab VMs und klicken Sie auf VM hinzufügen.

  3. Select the Windows version that matches your original Xen virtual machine.

  4. Konfigurieren Sie die Grundeinstellungen:

    • Name: Weisen Sie Ihrer VM einen beschreibenden Namen zu.
    • VirtIO-Treiber-ISO: Wählen Sie die gerade heruntergeladene Version aus.

  5. Unter Primärer vDisk-Speicherort:

    • Browse and select your existing Xen virtual disk.

  6. Fügen Sie eine temporäre sekundäre vDisk hinzu:

    • Klicken Sie auf das grüne Plus-Symbol.
    • Setzen Sie die Größe auf 1M (dies erzwingt IDE-Bus-Kompatibilität während des ersten Starts).
    • Wählen Sie ein beliebiges temporäres Verzeichnis für den Speicherort (dies wird später entfernt).

  7. Belassen Sie die anderen Einstellungen für Grafik und Sound auf ihren Standardwerten und klicken Sie dann auf Erstellen.

  8. Wenn die VM automatisch gestartet wird, stoppen Sie sie:

    • Bevorzugen Sie Stop (vermeiden Sie Erzwungenes Stoppen, es sei denn, die VM reagiert nicht).
    • Deaktivieren Sie alternativ Start VM nach Erstellung, wenn Sie die VM erstellen.

  9. Bearbeiten Sie die VM-Konfiguration:

    • Klicken Sie auf das VM-Symbol und wählen Sie Bearbeiten.
    • Wechseln Sie zur XML-Ansicht mit dem Schalter in der oberen rechten Ecke.

  10. Ändern Sie die XML der primären Festplatte:

    • Suchen Sie die <disk>-Sektion für Ihre primäre virtuelle Festplatte.
    • Entfernen Sie die gesamte <address>-Zeile.
    • Ändern Sie bus='virtio' zu bus='ide' im <target>-Tag.
    • Klicken Sie auf Aktualisieren.
Warum das temporäre Laufwerk?

Der 1MB temporäre Datenträger zwingt Unraid dazu, das primäre Laufwerk als hda (IDE) anstelle von vda (VirtIO) zuzuweisen, sodass Windows ohne VirtIO-Treiber starten kann. Dieser temporäre Datenträger wird nach der Treiberinstallation entfernt.

Schritt 5: Installieren Sie die VirtIO-Treiber - Klicken um zu erweitern/einzuklappen
  1. Starten Sie die VM über den VMs-Tab.
  2. Verbinden Sie sich über VNC, indem Sie auf das VM-Symbol klicken und Start mit Konsole (VNC) auswählen.
  3. Während des Starts:
    • Windows wird neue Hardware erkennen, aber möglicherweise nicht in der Lage sein, Treiber zu installieren.
    • Wählen Sie Später neu starten, wenn Sie dazu aufgefordert werden.
  4. Öffnen Sie den Geräte-Manager (drücken Sie Win+X und wählen Sie Geräte-Manager):
    • Installieren Sie Treiber für jedes Gerät unter Andere Geräte (wie Ethernet Controller, PCI-Gerät, etc.):
      1. Klicken Sie mit der rechten Maustaste auf das Gerät und wählen Sie Treiber aktualisieren.
      2. Wählen Sie Auf dem Computer nach Treibersoftware suchen.
      3. Weisen Sie auf das VirtIO-ISO-Laufwerk hin (zum Beispiel D:\).
      4. Aktivieren Sie Unterordner einbeziehen.
      5. Wenn Sie dazu aufgefordert werden, akzeptieren Sie Red Hat immer vertrauen.
  5. Installieren Sie den QEMU guest agent:
    • Öffnen Sie den Datei-Explorer und navigieren Sie zu D:\guest-agent\.
    • Doppelklicken Sie auf qemu-ga-x64.msi.
  6. Fahren Sie die VM herunter.
Schritt 6: Finalisieren Sie die VM-Konfiguration - Klicken um zu erweitern/einzuklappen
  1. Bearbeiten Sie die VM:
    • Entfernen Sie die temporäre sekundäre vDisk, indem Sie auf das rote Minus-Symbol klicken.
    • Confirm that the primary vDisk points to your original Xen disk.
  2. Aktualisieren Sie die VM:
    • Klicken Sie auf Aktualisieren, um Ihre Änderungen zu speichern.
  3. Starten Sie die VM normal.
  4. Überprüfen Sie im Geräte-Manager, dass:
    • Keine Warnsymbole erscheinen.
    • Alle Geräte verwenden VirtIO-Treiber (zum Beispiel "Red Hat VirtIO Ethernet-Adapter").
  5. (Optional) Aktivieren Sie VirtIO für eine bessere Leistung:
    • Bearbeiten Sie die VM und wechseln Sie zur XML-Ansicht.
    • Ändern Sie den bus der primären Festplatte von ide zu virtio.
    • Klicken Sie auf Aktualisieren und starten Sie die VM neu.
Treiber-Fehlerbehebung

Wenn Sie nach der Migration Fehler bei Geräten bemerken:

  1. Installieren Sie die VirtIO-Treiber von der ISO erneut.
  2. Überprüfen Sie Windows-Updates, die möglicherweise neuere Treiber bereitstellen.
  3. Besuchen Sie die Seite Red Hat VirtIO Drivers für die neuesten Versionen.