VM migrieren, exportieren und importieren
Verwenden Sie eine entbehrliche VM ohne Produktionsdaten. Melden Sie sich bei der XOA-HL-Appliance als Administrator an und prüfen Sie die Verfügbarkeit von Hosts, Speicher und VM. Migration und Export verschieben oder kopieren eine vollständige VM; keines von beiden ersetzt eine unabhängige Sicherung mit Wiederherstellungstest.
xoa-image-20261022-a280852, Paket v5.113.2_e281c536-ce40 (Xen Orchestra 5.113.2). Grundlage ist der veröffentlichte Code; Migration, Export und Import sind noch nicht auf einem Laborsystem getestet. Spätere Versionen können abweichen.1. Vorgang wählen
| Ziel | Vorgang | Ergebnis |
|---|---|---|
| Dieselbe VM auf einem anderen Host ihres Pools ausführen | Migrate | Dasselbe VM-Objekt; Datenträger bleiben auf gemeinsamem Speicher oder werden auf ein gewähltes SR kopiert |
| Eine portable Datei einer angehaltenen VM aufbewahren | Export als XVA | Eine vom Browser gespeicherte Datei; ohne Zeitplan, Aufbewahrung oder Wiederherstellungsprüfung |
| Aus einer XVA-Datei eine getrennte VM erstellen | Import | Ein neues VM-Objekt mit kopierten Gastidentitäten; wie einen Klon isolieren |
| Nach Verlust wiederherstellen | Sicherung und Wiederherstellung | Eine unabhängige, durch isolierte Wiederherstellung geprüfte Kopie |
Diese Anleitung behandelt Migration zwischen Hosts desselben Pools, XVA-Export ohne Komprimierung und Import einer XVA-Datei. Poolübergreifende Migration, Neuzuordnung von Netzwerken, OVA-Dateien, URL-Import, reiner Datenträgerimport/-export und VMware-Import liegen außerhalb ihres Umfangs. Das HomeLab-Menü blendet den VMware-Importeintrag aus.
Weitere, anhand des Quellcodes geprüfte Modi sind unter Weitere Übertragungsmodi beschrieben; die Abnahme auf einer Installation bleibt davon getrennt.
2. VM innerhalb ihres Pools migrieren
Vor dem Beginn zu prüfende Voraussetzungen:
- Der Pool hat mindestens zwei verbundene Hosts, und Sie besitzen Administrationsrechte für die VM und den Zielhost.
- Der Zielhost erreicht Netzwerke und Speicher der VM. Datenträger auf einem gemeinsamen SR benötigen keine Kopie. Ein Datenträger auf für das Ziel unerreichbarem Speicher, etwa einem lokalen SR, wird kopiert.
- Ein Wartungsfenster. Ein laufender Gast pausiert während einer Livemigration kurz; eine Datenträgerkopie dauert länger und benötigt freien Platz auf dem Ziel-SR.
- Eine Aufzeichnung von VM-ID, aktuellem Host, jedem Datenträger und seinem SR sowie einer Gastprüfung, etwa Konsolenanmeldung oder Anwendungstest.
- Öffnen Sie die VM und wählen Sie Migrate. Dies wird für laufende und angehaltene VMs angeboten, nicht für suspendierte oder pausierte. Self-Service-Benutzer sehen die Aktion nicht.
- Wählen Sie unter Migrate VM mit Select a destination host: einen anderen Host desselben Pools. Der aktuelle Host ist ausgenommen. Die Liste kann auch Hosts anderer verbundener Pools enthalten; wählen Sie diese in dieser Übung nicht.
- Lesen Sie den Speicherabschnitt. Liegen alle Datenträger auf einem gemeinsamen SR, ist keine SR-Auswahl nötig. Andernfalls verlangt XO ein Haupt-SR (Select main SR…) und erlaubt pro VDI ein eigenes SR. Wählen Sie beschreibbare SRs mit genug freiem Platz; diese Datenträger werden kopiert.
- Select a migration network: ist innerhalb eines Pools optional. XO wählt das konfigurierte Migrationsnetz des Pools vor, wenn der Zielhost dort eine Adresse hat. Jedes ausgewählte Netzwerk veranlasst XO, den Speichermigrationspfad statt einer einfachen Poolmigration zu verwenden. Behalten Sie den vorgeschlagenen Wert bei, sofern Ihr Poolentwurf kein anderes Netzwerk vorsieht.
- Bestätigen Sie und warten Sie auf das Aufgabenende. Klicken Sie nicht erneut, solange die Migration aussteht.
- Aktualisieren Sie General der VM. Prüfen Sie Host, Betriebszustand, Konsole, Gastnetz und Anwendung. Prüfen Sie nach einer Datenträgerkopie den neuen Ort jedes Datenträgers und den freien Platz beider SRs.
Meldet eine einfache Poolmigration, dass ein SR erforderlich ist, versucht XO sie automatisch als Speichermigration erneut. Dabei verwendet es mit dem Zielhost verbundene SRs oder das Standard-SR des Pools. Eine vermeintlich schnelle Migration kann dadurch zu einer Datenträgerkopie werden. Sichern Sie bei einem Migrationsfehler den Aufgabenfehler und prüfen Sie Host, Betriebszustand und Datenträger der VM auf jedem beteiligten SR vor einem erneuten Versuch. Wiederholen Sie nicht mit Zwang.
3. Angehaltene VM als XVA-Datei exportieren
Sie benötigen Administrationsrechte für die VM und genügend freien Platz auf dem Computer mit dem Browser.
- Fahren Sie den Gast sauber herunter und bestätigen Sie Halted. Notieren Sie VM-ID, Namen, Datenträger und ihre Gesamtgröße.
- Wählen Sie Export. Lassen Sie Type auf
xva. Lassen Sie Compression auf der Voreinstellung Disabled. Weitere Möglichkeiten sind GZIP (sehr langsam) und auf XCP-ng-Hosts Zstd. Der Import komprimierter XVAs wird hier nicht behandelt. - Bestätigen Sie. Download VM zeigt einen Downloadlink, OK und Cancel. Link und OK öffnen dieselbe URL, laut Meldung einmalig und nur kurz gültig. Verwenden Sie nur eines davon: Wählen Sie den Link und schließen Sie danach den Dialog mit Cancel. Die URL enthält ein einmaliges Zugriffstoken: Behandeln Sie sie bis zur Verwendung als Geheimnis.
- Der Browser speichert
<date> - <VM name>.xva. Lassen Sie den Download vollständig durchlaufen; Abbrechen stoppt den Export. Prüfen Sie die Dateigröße auf Plausibilität gegenüber den notierten Datenträgergrößen. - Erfassen Sie auf dem Browsercomputer eine Prüfsumme, beispielsweise mit
sha256sum "<file>.xva". Prüfen Sie die Datei damit vor einem Import.
Standardmäßig laufen höchstens zwei XVA-Exporte pro Pool gleichzeitig. Ein weiterer Download scheitert, statt zu warten. Lassen Sie laufende Exporte enden und fordern Sie dann einen neuen Link an.
Eine XVA enthält Datenträger und Konfiguration der VM. Bewahren Sie sie entsprechend den enthaltenen Daten auf und löschen Sie sie nach Testende. Eine Exportdatei hat weder Zeitplan noch Aufbewahrung oder Wiederherstellungsprüfung und ist daher kein Sicherungsauftrag.
[XO Export] <VM name>. Diese Kopie ist nicht anwendungskonsistent. XO löscht den Snapshot nach Downloadende. Scheitert das Löschen, wird nur eine Warnung protokolliert und der Snapshot kann auf dem SR verbleiben. Prüfen Sie nach einem Export im laufenden Zustand Snapshots der VM. Diese Anleitung verwendet stattdessen eine angehaltene VM.4. XVA als isolierte Kopie importieren
- Öffnen Sie Import > VM (
/#/import/vm). Der Menüeintrag erscheint nur, wenn Sie mindestens einen Pool bedienen dürfen. - Wählen Sie unter To Pool: den Zielpool. To SR: schlägt das Standard-SR des Pools vor. Wählen Sie ein beschreibbares SR mit ausreichend freiem Platz.
- Ziehen Sie die
.xva-Datei in den Bereich Drop OVA or XVA files here to import Virtual Machines. Prüfen Sie Dateiname und Größe in der Liste. Dateien ohne.xva- oder.ova-Endung werden ignoriert. Lassen Sie From URL deaktiviert. - Wählen Sie Import und lassen Sie den Browsertab bis zum Uploadende offen. Bei einer einzelnen Datei öffnet XO nach Erfolg die Seite der neuen VM.
- Lassen Sie die importierte VM angehalten. Notieren Sie ihre ID: Sie ist auch bei gleichem Namen ein anderes Objekt als die Quell-VM. Benennen Sie sie zur Vermeidung von Verwechslungen um.
- Öffnen Sie vor dem ersten Start Network und entfernen Sie jede virtuelle Schnittstelle oder sorgen Sie für nachgewiesene externe Isolation. Die Kopie enthält dasselbe Gastbetriebssystem, dieselben IP-Einstellungen, Hostnamen, Zugangsdaten und Anwendungsidentitäten wie die Quelle.
- Starten Sie die Kopie und prüfen Sie ihre Konsole sowie die notierten Testdaten.
XO verweigert den Start einer VM, deren Schnittstellen-MAC-Adresse eine ihrer eigenen oder die einer laufenden VM dupliziert. Der Fehlercode lautet DUPLICATED_MAC_ADDRESS. Erzwingen Sie den Start nicht; entfernen oder isolieren Sie zuerst die Schnittstelle.
Bei einem fehlgeschlagenen Import (VM import failed) können Objekte zurückbleiben. Prüfen Sie vor einem neuen Versuch die Datenträger des Ziel-SRs und die VM-Liste auf während des Versuchs erstellte Objekte. Entfernen Sie nur eindeutig identifizierte Überreste anhand des Verfahrens zum Entfernen einer entbehrlichen VM.
5. Aufräumen
- Entfernen Sie die importierte Test-VM mit dem Verfahren zum Entfernen einer entbehrlichen VM.
- Löschen Sie die XVA-Datei vom Computer und aus allen temporären Ablageorten.
- Prüfen Sie, dass die Quell-VM weiterhin auf dem erwarteten Host vorhanden ist und ihre Datenträger und Daten unverändert sind.
Stimmt etwas nicht, behalten Sie die Aufzeichnungen und melden Sie das Problem mit Versionen und bereinigten IDs.
Quellen
Geprüft anhand von XO-5-Commit e281c536 mit den veröffentlichten HomeLab-Patches: VM-Aktionsleiste, Migrations-, Export- und Importaktionen, Migrationsdialog, Standard-Migrationsnetz, Exportdialog, Komprimierungsoptionen, Importseite, VM-API, XAPI-Migration, Import- und Startprüfungen, Verarbeitung von Export-Snapshots, Exportparallelität und Oberflächenbezeichnungen. HomeLab-Menüänderungen: VMware-Importeintrag.
Weitere Übertragungsmodi (VM08)
Geltungsbereich: XO 5.113.2 e281c536, Quellen von XOA-HL ce40/ce47. Verwenden Sie einen Administrator und eine entbehrliche, über die Konsole erreichbare VM mit gewöhnlichen Datenträgern, einer auf den Datenträger geschriebenen Prüfsummen-Stichprobe, ohne VIFs, mit deaktivierten Jobs und genug Platz für temporäre Snapshots und Importe. Behalten Sie eine unabhängige Sicherung. Die Laborabnahme gilt jeweils nur für einen Modus.
- Export im laufenden Betrieb: Schreiben Sie die Stichprobe auf den Datenträger, lassen Sie die isolierte VM laufen, wählen Sie Export, Typ XVA und Komprimierung Disabled. Laden Sie die Datei vollständig herunter und notieren Sie Größe und Hash. Der Export im laufenden Betrieb verwendet einen temporären Snapshot
[XO Export]; prüfen Sie nach Abschluss oder Abbruch dessen Bereinigung und den Zustand der Quelle. Es ist kein anwendungskonsistenter Export und kein Export des Arbeitsspeichers. - Komprimierte XVA: Wiederholen Sie den Vorgang mit der Komprimierung GZIP (very slow) (
native); testen Sie Zstd nur gesondert, wenn der Host es anbietet. Notieren Sie die genaue Auswahl. Behalten Sie die Endung.xva. Importieren Sie jede vollständige Datei über Import → VM in das entbehrliche SR, wie im XVA-Verfahren. Schließen Sie aus einem erfolgreichen unkomprimierten Import nicht auf die Abnahme komprimierter Importe. - OVA: Exportieren Sie dieselbe isolierte VM mit dem Typ OVA; die XVA-Komprimierungsauswahl gilt hier nicht. Wählen Sie in Import → VM die heruntergeladene
.ova, prüfen Sie den ausgelesenen Namen, CPU, RAM, Datenträger und Netzwerke, wählen Sie das SR und importieren Sie einmal. Erfolgreiches Einlesen belegt weder den Gaststart noch die Originaltreue. Notieren Sie Fehler zu nicht unterstützten Datenträgern oder Formaten, ohne Datenträger umzuwandeln oder stillschweigend wegzulassen, damit der Import gelingt. - Import per URL: Legen Sie eine vollständige XVA mit bekanntem Hash unter einer vom Eigentümer kontrollierten URL ab, die die Appliance erreichen kann. Verwenden Sie Import → VM → From URL, Typ XVA, die genaue URL und das Test-SR. Die Appliance ruft die URL ab; Zugriff aus dem Browser genügt nicht. Tragen Sie keine Zugangsdaten in die URL ein. Dieser festgelegte Stand lehnt VM-Importe per URL ab, die keine XVA sind. Eine fehlgeschlagene Anfrage kann Objekte zurücklassen: Inventarisieren Sie vor einem neuen Versuch.
- Nur Datenträger: Verwenden Sie Import → Disk, wählen Sie das beschreibbare Test-SR und eine bekannte Datei
.vhd,.vmdkoder.raw(ISO hat eigene SR-Anforderungen). Prüfen Sie Name, Format, Größe und die entstandene VDI-UUID. Das erstellt einen Datenträger, keine startfähige VM. Hängen Sie ihn an einer freien Position an eine angehaltene Wiederherstellungs-VM an, entfernen Sie alle VIFs, starten Sie und prüfen Sie die Stichprobe. Im Reiter Disks der Quell-VM exportiert die Download-Aktion für Datenträger ein einzelnes VDI; wählen Sie ein angebotenes unterstütztes Format, speichern Sie die Datei, bilden Sie ihren Hash und importieren Sie sie für dieselbe Prüfung gesondert. Der Datenträgerimport per URL bietet in dieser Oberfläche nur ISO an; er ist kein allgemeiner VM-Import per URL und kein beliebiger Datenträgerkonverter.
Prüfen Sie bei jeder importierten VM eine eigene UUID, Anzahl, Größen und SRs der Datenträger sowie den Betriebszustand. Lassen Sie sie angehalten und entfernen Sie vor dem Start jedes übernommene VIF. Prüfen Sie den Start über die Konsole und die Prüfsumme der Stichprobe. Löschen Sie nach den Prüfungen nur identifizierte Testkopien und VDIs. Bewahren Sie bei einer Unterbrechung Datei und Fehler auf und vergleichen Sie die Inventare von Quelle, Ziel, Snapshots und Kapazität; ein Download-Dateiname oder eine Erfolgsmeldung ist kein Wiederherstellungstest.
Festgelegte Implementierung: packages/xo-server/src/api/vm.mjs, @xen-orchestra/xapi/vm.mjs, packages/xo-server/src/xapi/index.mjs, packages/xo-web/src/xo-app/vm-import/index.js, packages/xo-web/src/xo-app/disk-import/index.js, packages/xo-web/src/xo-app/vm/tab-disks.js, packages/xo-server/src/api/disk.mjs.
Laborergebnis, 03.11.2026 (teilweise, API statt Browser): Beobachtet über die REST- und JSON-RPC-Methoden für Export und Import, die diese Seiten verwenden. Ein Export des laufenden Laborgasts (4-GiB-Datenträger) wurde unkomprimiert mit 3.251.286.528 Byte abgeschlossen. vm.export mit compress auf gzip bzw. zstd lieferte gzip- (323.244.900 Byte) und zstd-Hüllen (295.357.297 Byte) desselben Archivs für die ganze Datei, keine Komprimierung je Block; beide entpacken auf 3.251.286.528 Byte. Der REST-Export akzeptiert nur ein boolesches compress. Der Import beider komprimierter Dateien per URL funktionierte (neue angehaltene VMs mit neuen MAC-Adressen). Der OVA-Export des laufenden Gasts erzeugte metadata.ovf und eine VMDK, aber das Hochladen dieser OVA an den Import-Endpunkt blieb über neun Minuten hängen und hinterließ eine teilweise VM [Importing...]; der OVA-Import ist daher nicht abgenommen. Der Datenträgerimport per URL akzeptierte nur VHD und raw; Importe von VMDK und QCOW2 per URL wurden abgelehnt, und ein QCOW2-Export lieferte HTTP 500 (unknown error). Eine als raw importierte VHD-Datei erzeugte einen falschen 2-MiB-Datenträger; geben Sie das Format daher korrekt an. Weder Gaststart noch Prüfsummen der Daten wurden geprüft, und der Modus bleibt offen.