OCI Image Migration-Utilitys

Oracle Linux 9

1. Aktivieren Sie das yum-Repository ol9_addons für Oracle Linux 9:

   sudo dnf config-manager --enable ol9_addons

2. Aktualisieren Sie Ihr System mit dem Befehl dnf update, und installieren Sie dann die erforderlichen Packages:

   sudo dnf update -y
   sudo dnf install -y python36-oci-sdk python36-oci-cli oci-utils-migrate

3. Wenn Sie eine physische Installation migrieren möchten, installieren Sie das Package qemu-img:

   sudo dnf install -y qemu-img

Oracle Linux 8

1. Aktivieren Sie das yum-Repository ol8_addons für Oracle Linux 8:

   sudo dnf config-manager --enable ol8_addons

2. Aktualisieren Sie Ihr System mit dem Befehl dnf update, und installieren Sie dann die erforderlichen Packages:

   sudo dnf update -y
   sudo dnf install -y python36-oci-sdk python36-oci-cli oci-utils-migrate

3. Wenn Sie eine physische Installation migrieren möchten, installieren Sie das Package qemu-img:

   sudo dnf install -y qemu-img

Oracle Linux 7 (erweiterter Support)

1. Aktivieren Sie die Repositorys ol7_addons und ol7_kvm_utils für Oracle Linux 7:

   sudo yum-config-manager --enable ol7_addons ol7_kvm_utils

2. Aktualisieren Sie Ihr System mit dem Befehl yum update, und installieren Sie dann die erforderlichen Packages:

   sudo yum update -y
   sudo yum install -y python36-oci-sdk python36-oci-cli oci-utils-migrate

3. Bei der Migration einer physischen Installation installieren Sie das Package qemu-img:

   sudo yum install -y qemu-img

Raw-Datenträgerimage erstellen

1. Bevor Sie den physischen Rechner zum Erstellen des Images herunterfahren, nehmen Sie vorübergehend alle Gerätetreiber in die anfängliche Ramdisk (initramfs) auf:

   sudo dracut --force --no-hostonly

2. Nachdem Sie den physischen Rechner heruntergefahren haben, erstellen Sie mit einem Recovery-System ein Datenträgerimage in einem externen Speicherort:

   sudo dd if=device_or_volume of=path_to_image bs=4M status=progress conv=sync,noerror

3. Wählen Sie als Datenträgerformat VMDK (kompatibel mit Oracle VM Virtualbox) oder QCOW2 (kompatibel mit Oracle Linux KVM) aus, und konvertieren Sie das Datenträgerimage.

Option 1: In VMDK (Virtual Machine Disk Format) konvertieren

1. Konvertieren Sie das Raw-Datenträgerimage in das VMDK-Format. Dieses Dateiformat wird für virtuelle Festplatten verwendet, die mit Oracle VM Virtualbox kompatibel sind.

   qemu-img convert -f raw -p -O vmdk raw_disk_image exported_file.vmdk

2. Testen Sie optional die virtuelle Festplatte, bevor Sie sie verpacken und in Oracle Cloud Infrastructure importieren.

   Weitere Informationen finden Sie im Abschnitt Datenträger-Imagedateien in der Oracle VM VirtualBox-Dokumentation. Weitere Informationen zum Befehl qemu-img finden Sie in der Manpage qemu-img(1).

3. Fahren Sie mit den Schritten unter Virtuelles Datenträgerimage zu Oracle Cloud Infrastructure migrieren fort.

Option 2: In QEMU-Format (Copy-on-Write-Format, QCOW2) konvertieren

1. Konvertieren Sie das Raw-Datenträgerimage in QEMU-Copy-on-Write (QCOW2). Dieses Speicherformat wird für virtuelle Festplatten verwendet, die mit Oracle Linux KVM kompatibel sind.

   qemu-img convert -f raw -p -c -O qcow2 raw_disk_image exported_file.qcow2

2. Testen Sie optional die virtuelle Festplatte, bevor Sie sie verpacken und in Oracle Cloud Infrastructure importieren.

   Weitere Informationen finden Sie im Kapitel Mit Speicher für KVM-Gäste arbeiten im Benutzerhandbuch für Oracle Linux KVM.

3. Fahren Sie mit den Schritten unter Virtuelles Datenträgerimage zu Oracle Cloud Infrastructure migrieren fort.

Voraussetzungen

Führen Sie vor der Migration die folgenden Schritte aus:

• Konfigurieren Sie Identity and Access Management.
• Erstellen Sie einen Bucket für Object Storage in Ihrem Oracle Cloud Infrastructure-Mandanten.
• Konfigurieren Sie das Oracle Cloud Infrastructure-SDK mit Ihren Zugangsdaten für den API-Zugriff. Siehe Setup und Voraussetzungen.
• Schließen Sie die Schritte unter Physische Installation in ein virtuelles Datenträgerimage konvertieren ab (wenn Sie einen physischen Host migrieren).

Wenn Sie neu bei Oracle Cloud Infrastructure sind, lesen Sie den Abschnitt Erste Schritte in der Oracle Cloud Infrastructure-Dokumentation.

Image mit den Utilitys migrieren

1. Sorgen Sie dafür, dass die Voraussetzungen erfüllt sind.
2. Prüfen Sie die virtuelle Festplatte im VMDK- oder QCOW2-Format, und bereiten Sie sie vor:

   sudo oci-image-migrate -y -i unprocessed_virtual_hard_disk

3. Laden Sie die vorverarbeitete virtuelle Festplatte als benutzerdefiniertes Image in einen Oracle Cloud Infrastructure-Bucket hoch:

   oci-image-migrate-upload -y -i processed_virtual_hard_disk -b bucket_name -o image_name

4. Importieren Sie die Imagedatei aus dem Objektspeicher in Ihrem Oracle Cloud Infrastructure-Bucket in Ihr benutzerdefiniertes Image-Repository:

   oci-image-migrate-import -y -i image_name -b bucket_name -c compartment_name

5. Generieren Sie bei der Migration von einem physischen Host initramfs mit dem importierten benutzerdefinierten Image auf jeder neuen Instanz erneut:

   sudo dracut --force

Beschreibung

Bereitet ein On-Premise-Image für den Import in Oracle Cloud Infrastructure vor. Sie müssen diesen Befehl als "root" ausführen.

Das Utility oci-image-migrate unterstützt die Migration von Imagedateien in den Formaten qcow2 und vmdk.

Das Utility führt folgende Schritte aus, um das Image für die Migration vorzubereiten:

• Es prüft die Voraussetzungen für den Import des Images.
• Es deaktiviert die Netzwerkschnittstellen außer der primären Netzwerkschnittstelle, die als DHCP-Client eingerichtet ist.
• Es installiert empfohlene Packages wie das cloud-init-Package. Die Liste der installierten Packages wird in der Datei /etc/oci-utils/oci-migrate-conf.yaml angezeigt.
• Es versucht, auf Remoteserver zuzugreifen, die Software-Repositorys für das verarbeitete Image hosten. Die Software-Repositorys müssen für die Domain Name Server-(DNS-)Name Server und Proxyeinstellungen erreichbar sein.
• Es setzt den Standard-Cloud-Benutzer auf opc.

Verwendung

Optionen

-i unprocessed_virtual_hard_disk | --input-image unprocessed_virtual_hard_disk

Geben Sie den vollständigen Pfad für die nicht verarbeitete virtuelle Festplatte an. Diese Option ist obligatorisch.

-y | --yes

Beantworten Sie Prompts mit "yes".

-v | --verbose

Zeigen Sie detaillierte Informationen während der Imageverarbeitung im Terminal an. Diese Informationen können zur Fehlerbehebung oder Statusüberwachung verwendet werden. Diese Debugginginformationen werden auch in /var/tmp geschrieben.

-h | --help

Zeigen Sie eine Übersicht über die Befehlszeilenoptionen an.

Beispiel

$ sudo oci-image-migrate /omv/data/images/ol79.vmdk -v
2021-03-30 20:38:38,177 - oci-utils.migrate-tools - DEBUG(migrate_tools:223) - __ Get config data: helpers_list
2021-03-30 20:38:38,205 - oci-utils.migrate-tools - DEBUG(migrate_tools:223) - __ Get config data: lc_all
...

Beschreibung

Lädt eine On-Premise-Imagedatei in einen Objektspeicher-Bucket in Oracle Cloud Infrastructure hoch. Für diesen Befehl sind keine Root-Berechtigungen erforderlich, sofern Sie auf den Objektspeicher-Bucket in Oracle Cloud Infrastructure zugreifen können und über Schreibberechtigungen für die Verzeichnisse verfügen, in die die Log- und Ergebnisdateien geschrieben werden (/var/tmp/).

Verwendung

Optionen

-i processed_virtual_hard_disk | --input-image processed_virtual_hard_disk

Geben Sie den vollständigen Pfad für die verarbeitete virtuelle Festplatte an. Diese Option ist obligatorisch.

-b bucket_name | --bucket-name bucket_name

Geben Sie den Namen des Objektspeicher-Buckets in Oracle Cloud Infrastructure an, um die Imagedatei zu speichern. Diese Option ist obligatorisch.

-o output_name | --output-name output_name

Geben Sie den Namen der Imagedatei an, die im Objektspeicher verwendet werden soll. Wenn Sie keinen Namen angeben, wird der Name der verarbeiteten virtuellen Festplatte als Imagename verwendet.

-y | --yes

Beantworten Sie Prompts mit "yes".

-v | --verbose

Zeigen Sie detaillierte Informationen während der Imageuploadverarbeitung im Terminal an. Diese Informationen können zur Fehlerbehebung oder Statusüberwachung verwendet werden. Diese Debugginginformationen werden auch in /var/tmp geschrieben.

-h | --help

Zeigen Sie eine Übersicht über die Befehlszeilenoptionen an.

Beispiel

$ oci-image-migrate-upload -v -i /omv/data/images/ol79.vmdk -b test_bucket_001 -o ol79_demo.qcow2

  Uploading ol79.vmdk -b test_bucket_001 -o ol79_demo.qcow2 at Thu Mar 25 20:44:16 2021
  Uploading /omv/data/images/ol79.vmdk to object storage test_bucket_001 in the Oracle Cloud Infrastructure as ol79_demo.qcow2
  Object storage test_bucket_001 present.
  Agree to proceed uploading /omv/data/images/ol79.vmdk to test_bucket_001 as ol79_demo.qcow2? (y/N) y


  Uploading /omv/data/images/ol79.vmdk, this may take a while....
  00:03:12 [          uploading ol79_demo.qcow2

Beschreibung

Importiert ein Image aus dem Objektspeicher in das Repository für benutzerdefinierte Images in Oracle Cloud Infrastructure. Für diesen Befehl sind keine Root-Berechtigungen erforderlich, sofern Sie auf den Objektspeicher-Bucket in Oracle Cloud Infrastructure zugreifen können und über Schreibberechtigungen für die Verzeichnisse verfügen, in die die Log- und Ergebnisdateien geschrieben werden (/var/tmp/).

Verwendung

Optionen

-i image_name | --input-image image_name

Geben Sie den Namen des Images an, das als benutzerdefiniertes Image importiert werden soll. Diese Option ist obligatorisch.

-b bucket_name| --bucket-name bucket_name

Geben Sie den Namen des Objektspeicher-Buckets in Oracle Cloud Infrastructure an, in dem die Imagedatei gespeichert ist. Diese Option ist obligatorisch.

-c compartment_name | --compartment-name compartment_name

Geben Sie den Namen des Ziel-Compartments an. Diese Option ist obligatorisch.

-d display_name | --display-name display_name

Geben Sie den Namen an, der für das benutzerdefinierte Image im Repository für benutzerdefinierte Images in Oracle Cloud Infrastructure angezeigt werden soll. Wenn dieser Parameter nicht angegeben ist, wird der Imagename als Anzeigename verwendet.

-l launch_mode | --launch-mode launch_mode

Geben Sie den Startmodus an, den das benutzerdefinierte Image beim Starten verwendet. Mögliche Werte sind PARAVIRTUALIZED, EMULATED und NATIVE. Wenn kein Modus angegeben ist, lautet der Standardwert PARAVIRTUALIZED.

-v | --verbose

Zeigen Sie detaillierte Informationen während der Imageimportverarbeitung im Terminal an. Diese Informationen können zur Fehlerbehebung oder Fortschrittsüberwachung verwendet werden. Diese Debugginginformationen werden auch in /var/tmp geschrieben.

-y | --yes

Beantworten Sie Prompts mit "yes".

-h | --help

Zeigen Sie eine Übersicht über die Befehlszeilenoptionen an.

Beispiel

$ oci-image-migrate-import -v -y -i ol79_demo.qcow2 -b test_bucket_001 -c OLimages -d ol79_demo

  Importing ol79_demo.qcow2 from test_bucket_001 into test_bucket_001 as ol79_demo and setting launch mode as PARAVIRTUALIZED
  Object storage namespace: IMAGETEST
  Compartment: OLimages
  Object storage test_bucket_001 present.
  Import ol79_demo.qcow2 to OLimages as ol79_demo y
  00:00:05 [               importing ol79_demo