Sie können das VMware Cloud Director service-Migrationstool verwenden, um Ihre lokale VMware Cloud Director-Installation zu VMware Cloud Director service zu migrieren.

Verwenden Sie das Migrationstool, um nahtlos zu VMware Cloud Director service zu migrieren und gleichzeitig Ihre SDDC-Ressourcen lokal zu halten. Verwenden Sie nach einer erfolgreichen Migration VMware Cloud Director service zum Verwalten Ihrer lokalen SDDC-Ressourcen.

Zur Erleichterung der Migration können Sie im Verzeichnis /tmp Ihres Hosts eine Datei migration.properties mit wiederverwendbaren Parametern und den entsprechenden Werten erstellen, z. B. den Hostnamen für Ihre lokale Instanz, die Organisations-ID für die VMware Cloud-Organisation, in die Sie Ihre Bereitstellung migrieren, usw., und zwar im folgenden Format.
SITE_NAME=migration.eng.example.com
SITE_ADMIN_USERNAME=administrator
IS_APPLIANCE=true/false
CSP_ORG_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
CSP_ORG_REFRESH_TOKEN=API Token
CELL_USERNAME=root
DBHOST_USERNAME=root

Während der Migration fordert das Migrationstool Sie auf, die Werte aus der Datei zu verwenden oder benutzerdefinierte Werte für jeden Parameter einzugeben. Wenn Sie sich dafür entscheiden, die Datei migration.properties nicht vor der Migration zu erstellen, wird sie vom Migrationstool erstellt und mit den Werten gefüllt, die Sie während der Migration eingeben. Sie können die Datei dann für nachfolgende Migrationen wiederverwenden.

Hinweis: Eine Migration kann je nach Größe Ihrer VMware Cloud Director-Datenbank und Ihrer Internet-Bandbreite zwischen 10 Minuten und einigen Stunden dauern.
Tabelle 1. Unterstützte Migrationspfade
Version der lokalen Quellumgebung VMware Cloud Director service-Migrationsunterstützung
VMware Cloud Director 10.3.3 VMware Cloud Director service (10.3.3)
VMware Cloud Director 10.4 VMware Cloud Director service (10.4)
VMware Cloud Director 10.4.1 VMware Cloud Director service (10.4.1)

Voraussetzungen

  • Um die Kompatibilität zwischen Ihrer lokalen VMware Cloud Director-Umgebung und dem VMware Cloud Director service zu überprüfen, stellen Sie sicher, dass der Lastausgleichsdienst, der Ihrer lokalen Installation vorangestellt ist, öffentlich zugänglich ist.
  • Wenden Sie sich an VMware Support, um sicherzustellen, dass Ihre VMware Cloud-Organisation die Migration unterstützt. Weitere Informationen hierzu finden Sie unter Vorgehensweise zum Einreichen einer Migrations-Support-Anfrage.
  • Stellen Sie sicher, dass Sie die Support-Pakete curl, jq, zip, ssh, scp, sshpass und md5sum auf dem Host installiert haben, von dem Sie die Migration durchführen möchten.
  • Ermitteln Sie den VMware Cloud Director-Hostnamen, den Administrator-Benutzernamen und das Administrator-Kennwort für diesen Host.
  • Notieren Sie sich den lokalen VMware Cloud Director-Bereitstellungstyp – Appliance oder Linux-basiert.
  • Wenn Sie eine Appliance-Bereitstellung verwenden, notieren Sie sich die Anmeldedaten für das primäre und das Zellbetriebssystem.
  • Wenn Sie eine Linux-Bereitstellung verwenden, notieren Sie sich die Anmeldedaten für das aktive Zellenbetriebssystem und die Anmeldedaten für das Hostbetriebssystem der externen Datenbank.
  • Generieren Sie ein API-Token für VMware Cloud und speichern Sie die Token-Anmeldedaten. Der Geltungsbereich des Tokens muss die Dienstrollen Administrator und NSX Cloud-Admin sowie die Organisationsrolle Entwickler oder Organisationsbesitzer enthalten. Siehe Vorgehensweise zum Generieren eines API-Tokens.
  • Überprüfen Sie, ob die Migration für die von Ihnen verwendete VMware Cloud Director-Konfiguration unterstützt wird. Weitere Informationen finden Sie unter Einschränkungen bei der Migration von VMware Cloud Director zu VMware Cloud Director Service.
  • Vergewissern Sie sich, dass Ihre lokale Konfiguration mit den vom VMware Cloud Director service unterstützten Skalierungshöchstwerten übereinstimmt. Weitere Informationen finden Sie unter Konfigurationshöchstwerte für VMware Cloud Director Service.
  • Laden Sie das Migrationsskript von https://github.com/vmware-samples/cloud-director-service-migration auf den Host herunter, von dem es ausgeführt werden soll.

Prozedur

  1. Führen Sie den Befehl aus, um das Migrationstool zu starten.
    sh migrate.sh
  2. Wenn Sie eine Datei migration.properties erstellt haben, bestätigen Sie die Wiederverwendung des Dateiinhalts und fahren Sie mit Schritt 5 fort.
    1. Geben Sie bei Aufforderung y ein, um die Wiederverwendung der Datei migration.properties zu bestätigen.
    2. Geben Sie bei Aufforderung y ein, um den Hostnamen für die lokale VMware Cloud Director-Instanz wiederzuverwenden.
    3. Geben Sie bei Aufforderung y ein, um den Administrator-Benutzername wiederzuverwenden.
  3. Geben Sie bei Aufforderung den Hostnamen für die lokale VMware Cloud Director-Instanz ein.
  4. Geben Sie bei Aufforderung den Administrator-Benutzernamen oder die lokale VMware Cloud Director-Instanz ein.
  5. Geben Sie bei Aufforderung das Administrator-Kennwort oder die lokale VMware Cloud Director-Instanz ein.
  6. Geben Sie bei der Aufforderung an, ob es sich bei Ihrer lokalen Bereitstellung um eine Appliance handelt, oder verneinen Sie dies.
  7. Wenn Sie eine Appliance-Bereitstellung verwenden, geben Sie die Anmeldedaten für die primäre VMware Cloud Director-Appliance-Zelle ein.
    1. Geben Sie bei Aufforderung den Benutzernamen root für die Zelle ein oder bestätigen Sie die Wiederverwendung des Werts aus der Datei migration.properties.
    2. Geben Sie bei Aufforderung ein Root-Kennwort ein.
  8. Wenn Sie eine Linux-Installation verwenden, geben Sie nach Aufforderung die Anmeldedaten für den Datenbank-Host ein.
    1. Geben Sie bei Aufforderung den Hostnamen ein oder bestätigen Sie die Wiederverwendung des Werts aus der Datei migration.properties.
    2. Geben Sie bei Aufforderung den Datenbankbenutzernamen ein oder bestätigen Sie die Wiederverwendung des Werts aus der Datei migration.properties.
    3. Geben Sie bei Aufforderung das Datenbankkennwort ein.
  9. Geben Sie bei Aufforderung die lange Organisations-ID für die VMware Cloud-Organisation ein, in der Sie Ihre VMware Cloud Director service-Instanz bereitstellen möchten, oder bestätigen Sie die Wiederverwendung des Werts aus der Datei.
  10. Geben Sie bei Aufforderung das VMware Cloud-API-Zugriffstoken für die VMware Cloud-Organisation ein, das Sie erstellt haben.
  11. Wenn Sie über mehr als eine VMware Cloud Director service-Umgebung verfügen, wählen Sie nach Aufforderung eine Umgebung aus, in die VMware Cloud Director migriert werden soll, und geben Sie die Umgebungsnummer ein.
  12. Geben Sie bei Aufforderung einen Namen für die VMware Cloud Director service-Instanz ein, auf die Ihre lokale Bereitstellung migriert werden soll.
    Ihre lokale VMware Cloud Director-Instanz wurde erfolgreich zu VMware Cloud Director service migriert.
  13. Verknüpfen Sie die neu erstellte VMware Cloud Director-Instanz mit einem SDDC über VMware Reverse Proxy.

Beispiel: Migration zu VMware Cloud Director service

In diesem Beispiel werden die Schritte beschrieben, die erforderlich sind, um die Migration einer Linux-Bereitstellung zu VMware Cloud Director service mithilfe des Migrationstools und einer migration.properties-Datei durchzuführen.
SITE_NAME=migration.eng.example.com
SITE_ADMIN_USERNAME=administrator
IS_APPLIANCE=false
CSP_ORG_ID=11111111-2222-3333-4444-555555555555
CSP_ORG_REFRESH_TOKEN=Ab4XdNsdMeNFVSHA8q3ze8ebR0t4Hik7lSs6DZJTFoF_wcQaTWw7U6O8ZLk6j4IM
CELL_USERNAME=root
DBHOST_USERNAME=root

Führen Sie den Befehl aus, um das Migrationstool zu starten.

sh migrate.sh

Das Tool fordert Sie auf, auszuwählen, ob Sie die Datei migration.properties verwenden möchten, und bei einigen Schritten zusätzliche Eingaben zu machen.

Die Ausgabe für eine erfolgreiche Migration sieht ähnlich aus wie die folgende.
Migration Input properties file present, wish to reuse [y/n]: y
Script will reuse the input values located in /tmp/migration.properties
Site FQDN name (found: migration.eng.example.com), wish to reuse [y/n]: y
Site admin user name (found: administrator), wish to reuse [y/n]: y
Enter admin password for on-prem VCD site migration.eng.example.com: xxxxx
Successfully collected administrator credentials for migration.eng.example.com
Is migration.eng.example.com appliance based (found: false), wish to reuse [y/n]: y
Found active Cell: migration-vcd1.eng.example.com
Username for cell migration-vcd1.eng.example.com  (found: root), wish to reuse [y/n]: y
Enter password for cell migration-vcd1.eng.example.com: xxxxxx
Successfully collected root credentials for migration-vcd1.eng.example.com
Successfully downloaded responses.properties from migration-vcd1.eng.example.com
Found Database HOSTNAME: migration-db.eng.example.com
Found Database Name: vcloud
Username for DB Host migration-db.eng.example.com (found: root), wish to reuse [y/n]: y
Enter password for DB Host migration-db.eng.example.com: xxxxx
Successfully collected root credentials for migration-db.eng.example.com
CSP ORG ID (found: 11111111-2222-3333-4444-555555555555), wish to reuse [y/n]: y
CSP ORG refresh Token (found: Ab4XdNsdMeNFVSHA8q3ze8ebR0t4Hik7lSs6DZJTFoF_wcQaTWw7U6O8ZLk6j4IM), wish to reuse [y/n]: y
Retrieving list of environments associated for org: 11111111-2222-3333-4444-555555555555
Found following 4 environments in org: 11111111-2222-3333-4444-555555555555
US West - Oregon (66666)
Australia - Sydney (77777)
Europe - Germany (88888)
Asia - Japan (99999)
Select environment for CDI migration: values (1-5)] : 1
Selected Environment: US West - Oregon (66666)
Compatibility Check Succeeded, found upgrade category: release-10.3:production
Successfully collected all required resources from migration.eng.example.com for migration
Enter CDI Name to migrate: MigratedInstance
Uploading collected resources from migration.eng.example.com for migration
Upload Resource Task URN: urn:vcdc:task:99999999-8888-7777-6666-555555555555
Setting up maintenance mode on all cloud cells
Entering maintenance mode on migration-vcd1.eng.example.com
Successfully entered maintenance mode.
Successfully entered maintenance mode on migration-vcd1.eng.example.com
Entering maintenance mode on migration-vcd2.eng.example.com
Successfully entered maintenance mode.
Successfully entered maintenance mode on migration-vcd2.eng.example.com
Entering maintenance mode on migration-vcd3.eng.example.com
Successfully entered maintenance mode.
Successfully entered maintenance mode on migration-vcd3.eng.example.com
Successfully entered maintenance mode on all cloud cells
Migrate to CDI Task ID: urn:vcdc:task:888888888-7777-6666-5555-4444444444444
Migrate to CDI task run status: IN_PROGRESS - Deploying instance
Migrate to CDI task run status: IN_PROGRESS - Waiting for service to be available
Migrate to CDI task run status: IN_PROGRESS - Backup VMware Cloud Director database schema
Migrate to CDI task run status: IN_PROGRESS - Waiting for all cells to be ready
Migrate to CDI task run status: IN_PROGRESS - Creating groups in system org
Migrate to CDI task run status: IN_PROGRESS - Integrating VCD micrometer metrics with Wavefront
Migrate to CDI task run status: SUCCESS -
Migrate to CDI status SUCCESS for task urn:vcdc:task:888888888-7777-6666-5555-4444444444444