Mit dem CLI-Installationsprogramm können Sie einen vCenter Server oder Platform Services Controller automatisch von Windows auf eine Appliance migrieren.

Die ISO-Installationsdatei enthält Beispielvorlagen zu JSON-Dateien mit den Mindestkonfigurationsparametern, die für das Migrieren einer vCenter Server- oder Platform Services Controller-Instanz von Windows auf eine Appliance erforderlich sind. Die Beispielvorlagen befinden sich im Verzeichnis vcsa-cli-installer/templates/migrate.

Hinweis: Bevor Sie eine vCenter Server-Bereitstellung mit einem externen Platform Services Controller migrieren, müssen Sie zuerst den externen Platform Services Controller in einen eingebetteten Platform Services Controller konvergieren und dann die Migration durchführen. Informationen dazu finden Sie im Knowledgebase-Artikel KB 68137.

CLI-Aufgaben für die Migration Ihrer vCenter Server-Installation von Windows zu einer Appliance:

1. GUID-11468F6F-0D8C-41B1-82C9-29284630A4FF.html#GUID-11468F6F-0D8C-41B1-82C9-29284630A4FF.
2. GUID-50A5705E-80E7-4305-BB43-B041D4B206E8.html#GUID-50A5705E-80E7-4305-BB43-B041D4B206E8.
3. GUID-9E0F567C-BA00-42D5-AC74-8497BDC61192.html#GUID-9E0F567C-BA00-42D5-AC74-8497BDC61192.
4. Führen Sie vor der Migration die Vorabprüfung durch.
5. GUID-44148385-BDFE-4C67-BB35-C132D331BB8A.html#GUID-44148385-BDFE-4C67-BB35-C132D331BB8A.

Sie können das CLI-Installationsprogramm mehrmals mit unterschiedlichen JSON-Dateien ausführen, um mehrere CLI-Migrationen durchzuführen, oder Sie können die CLI-Migrationen gleichzeitig im Batch-Modus ausführen.

Wichtig: Der Benutzername, mit dem Sie sich bei dem Computer anmelden, über den Sie das CLI-Installationsprogramm ausführen möchten, der Pfad des Installationsprogramms der vCenter Server Appliance, der Pfad der JSON-Konfigurationsdatei und die Zeichenfolgenwerte in der JSON-Konfigurationsdatei, einschließlich der Kennwörter, dürfen nur ASCII-Zeichen enthalten. Erweiterte ASCII- und Nicht-ASCII-Zeichen werden nicht unterstützt.

Vorbereiten der JSON-Konfigurationsdateien für die CLI-Migration

Wenn Sie eine vCenter Server-Quellinstallation unter Verwendung der CLI zu einem vCenter Server Appliance-Ziel migrieren, müssen Sie eine JSON-Vorlage mit den Konfigurationswerten für die neue Appliance vorbereiten.

Sie können vCenter Server- oder Platform Services Controller-Instanzen von Windows zu einer vCenter Server Appliance migrieren, indem Sie in den in der ISO-Datei des Installationsprogramms verfügbaren Vorlagen Werte für die Konfigurationsparameter festlegen. Für Konfigurationsparameter, die nicht in den Vorlagen enthalten sind, werden die jeweiligen Standardwerte verwendet. Sie können den Vorlagen Konfigurationsparameter hinzufügen, um deren Werte für Ihre Migrationsspezifikation festzulegen.

Das Verzeichnis vcsa-cli-installer/templates/migrate enthält Beispielmigrationsvorlagen für die CLI-Migration von vCenter Server 6.7 zu einer Appliance.

Navigieren Sie zum Unterverzeichnis des Installationsprogramms für Ihr Betriebssystem und führen Sie den Befehl vcsa-deploy migrate --template-help aus, um eine vollständige Liste der Konfigurationsparameter und ihrer Beschreibungen zu erhalten.

Wichtig: Der Benutzername, mit dem Sie sich bei dem Computer anmelden, über den Sie das CLI-Installationsprogramm ausführen möchten, der Pfad des vCenter Server Appliance-Installationsprogramms, der Pfad der JSON-Konfigurationsdatei und die Zeichenfolgenwerte in der JSON-Konfigurationsdatei, einschließlich der Kennwörter, dürfen nur ASCII-Zeichen enthalten. Erweiterte ASCII- und Nicht-ASCII-Zeichen werden nicht unterstützt.

Um die Batch-Migration durchzuführen, platzieren Sie die JSON-Vorlagen, die Ihre Bereitstellung definieren, in einem einzigen Verzeichnis. Nach dem Aufrufen migriert das CLI-Installationsprogramm Ihre vorhandene Bereitstellung unter Verwendung der in den JSON-Vorlagen definierten Topologie auf die neue vCenter Server-Version.

Voraussetzungen

Vergewissern Sie sich, dass Ihre Umgebung die Anforderungen für die Migration erfüllt. Weitere Informationen hierzu finden Sie unter Systemanforderungen zum Migrieren von vCenter Server-Bereitstellungen zu Bereitstellungen der vCenter Server-Appliance.

Bereiten Sie Ihre Umgebung für die Migration vor. Weitere Informationen hierzu finden Sie unter Vorbereiten für die Migration.

Prozedur

1. Öffnen Sie den Unterordner migrate im Verzeichnis vcsa-cli-installer/templates.
2. Kopieren Sie die Migrationsvorlage aus dem Unterordner migrate in Ihren Arbeitsbereich. Verwenden Sie für vCenter Server 6.7 den Ordner migrate/winvc6.7/.
3. Öffnen Sie die Vorlagendatei für Ihren Anwendungsfall in einem Texteditor.
   Verwenden Sie einen JSON-Editor, um die korrekte Syntax der JSON-Konfigurationsdatei zu gewährleisten.
4. Geben Sie Werte für die erforderlichen Konfigurationsparameter ein und geben Sie optional zusätzliche Parameter und deren Werte ein.
   Wichtig: Um einen Wert festzulegen, der einen umgekehrten Schrägstrich (\) oder ein Anführungszeichen (") enthält, müssen Sie dem Zeichen einen umgekehrten Schrägstrich (\) voranstellen. Beispiel: Mit "password":"my\"password" wird das Kennwort "mein Kennwort" und mit "image":"C:\\vmware\\vcsa" der Pfad C:\vmware\vcsa festgelegt.

   Die booleschen Werte dürfen nur Kleinbuchstaben enthalten. Entweder true oder false Beispielsweise "ssh_enable":false

5. Speichern Sie die Datei im UTF-8-Format und schließen Sie sie.

Ergebnisse

Ihre Datei kann jetzt für die Migration verwendet werden.

Nächste Maßnahme

Sie können so viele Vorlagen erstellen und speichern, wie für die jeweilige Bereitstellung benötigt werden. Wenn Ihre Vorlage fertig ist, führen Sie die Vorabprüfung aus, bevor Sie die Vorlage zum Ausführen der Migration verwenden. Weitere Informationen hierzu finden Sie unter GUID-2F4C94BA-3C77-48F2-9D22-053187BA7BC1.html#GUID-2F4C94BA-3C77-48F2-9D22-053187BA7BC1.

JSON-Vorlagen für die CLI-Migration von vCenter Server für Windows

Das Installationsprogramm für vCenter Server enthält JSON-Vorlagen, die sich im Verzeichnis vcsa-cli-installer/templates befinden. Im Unterordner migrate befinden sich die JSON-Vorlagen mit den Mindestkonfigurationsparametern für alle unterstützten Migrationstypen.

Tabelle 1. Im vCenter Server-Installationsprogramm enthaltene JSON-Migrationsvorlagen

Speicherort	Vorlage	Beschreibung
vcsa-cli-installer\templates\migrate\vcsa\winvc6.7	embedded_win_vc_to_embedded_vCSA_on_ESXi.json	Enthält die Mindestkonfigurationsparameter, die für die Migration von vCenter Server 6.7 unter Windows mit einem eingebetteten Platform Services Controller auf vCenter Server Appliance 8.0 auf einem ESXi-Host erforderlich sind.
	embedded_win_vc_to_embedded_vCSA_on_VC.json	Enthält die Mindestkonfigurationsparameter, die für die Migration von vCenter Server 6.7 unter Windows mit einem eingebetteten Platform Services Controller auf vCenter Server Appliance 8.0 auf einer vCenter Server-Instanz erforderlich sind.
	win_vc_to_vCSA_on_ESXi.json	Enthält die Mindestkonfigurationsparameter, die für die Migration von vCenter Server 6.7 unter Windows mit einem externen Platform Services Controller auf vCenter Server Appliance 8.0 auf einem ESXi-Host erforderlich sind.
	win_vc_to_vCSA_on_VC.json.json	Enthält die Mindestkonfigurationsparameter, die für die Migration von vCenter Server 6.7 unter Windows mit einem externen Platform Services Controller auf vCenter Server Appliance 8.0 auf einer vCenter Server-Instanz erforderlich sind.

Informationen zum Migrieren eines vCenter Server für Windows mit einem externen Platform Services Controller über die CLI

Wenn Sie einen vCenter Server für Windows migrieren, der einen externen Platform Services Controller verwendet, wird dieser in eine vCenter Server-Instanz mit diesen in die Appliance eingebetteten Diensten konvertiert Aus diesem Grund müssen Sie die Parameter für den Replizierungspartner in den JSON-Migrationsvorlagen angeben.

Wenn Sie einen vCenter Server für Windows migrieren, der einen externen Platform Services Controller verwendet, müssen Sie Parameter für den Replizierungspartner in der JSON-Migrationsvorlage angeben. Mit diesen Parametern wird angegeben, ob die Migration für eines der folgenden vCenter Server- und Platform Services Controller- Migrationsszenarios vorgesehen ist.

• Eine einzelne vCenter Server- und eine einzelne Platform Services Controller-Instanz in einer SSO-Domäne.
• Die erste vCenter Server- und Platform Services Controller-Instanz innerhalb einer SSO-Domäne, die mehr als einen vCenter Server enthält.
• Replizieren Sie vCenter Server- und Platform Services Controller-Instanzen innerhalb einer SSO-Domäne, die Sie einer vorhandenen vCenter Server 7.0-Instanz als Replizierungspartner zuweisen müssen.

Wichtig: Vor der Migration einer vCenter Server-Bereitstellung mithilfe eines externen Platform Services Controller müssen Sie zuerst den externen Platform Services Controller in einen eingebetteten Platform Services Controller konvergieren und dann die Migration durchführen. Weitere Informationen finden Sie unter GUID-2360F9C9-EDBD-4362-B898-0B291AF1560E.html#GUID-2360F9C9-EDBD-4362-B898-0B291AF1560E.

Bereitstellungen, die einen externen Platform Services Controller verwenden, werden häufig als MxN-Bereitstellung bezeichnet, wobei M den vCenter Server und N den externen Platform Services Controller darstellt. Wenn mehrere Instanzen von vCenter Server und Platform Services Controller in einer Domäne dargestellt werden, wird dies als MnxNn ausgedrückt, wobei mit n die Anzahl der Instanzen angegeben wird. Beispielsweise gibt M2xN2 zwei vCenter Server-Instanzen und zwei Platform Services Controller-Instanzen innerhalb derselben Domäne an. Bei der Migration einer solchen Bereitstellung müssen Sie zuerst eine Instanz auf Version 8.0 und dann die zweite Instanz auf 8.0 migrieren, wobei die erste der beiden Instanzen als Replizierungspartner angegeben wird.

Die Replizierungsparameter in der JSON-Migrationsvorlage befinden sich im Abschnitt sso der Vorlage und lauten first_instance und replication_partner_hostname.

Parametername	Beschreibung
first_instance	Der Parameter first_instance erkennt den vCenter Server entweder als erste Instanz in Ihrer vCenter Server-SSO-Domäne oder als Replizierungspartner. Wenn es sich um die erste vCenter Server-Instanz handelt, legen Sie first_instance auf true fest. Für weitere Instanzen von vCenter Server in derselben SSO-Domäne legen Sie first_instance auf false fest.
replication_partner_hostname*	Wenn Sie first_instance auf false festlegen, müssen Sie den FQDN oder die IP-Adresse eines vCenter Server angeben, der bereits auf Version 8.0 migriert und dessen externer PSC in die vCenter Server Appliance konvergiert wurde.

Wenn Sie die CLI-Migration eines einzelnen vCenter Server für eine Windows-Instanz durchführen, die einen externen Platform Services Controller verwendet, sieht der Prozess folgendermaßen aus:

1. Migrieren Sie den vCenter Server in Ihrer Topologie mithilfe der Vorlage win_vc_to_vCSA_on_ESXi.json bei der Migration auf ESXi oder mithilfe der Vorlage win_vc_to_vCSA_on_VC.json bei der Migration auf eine vCenter Server-Bereitstellung.

2. Bearbeiten Sie für eine Bereitstellungstopologie, die aus einem einzelnen vCenter Server und einem Platform Services Controller (einer M1xN1-Bereitstellung) besteht, den Abschnitt sso der Vorlage so, dass der Parameter first_instance auf true festgelegt wird, und entfernen Sie den Parameter replication_partner_hostname.

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. Geben Sie die verbleibenden Konfigurationsparameter in der JSON-Vorlage an und migrieren Sie vCenter Server mithilfe der CLI auf Version 8.0. Weitere Informationen hierzu finden Sie unter GUID-44148385-BDFE-4C67-BB35-C132D331BB8A.html#GUID-44148385-BDFE-4C67-BB35-C132D331BB8A.
4. Setzen Sie nach der Migration von vCenter Server den Platform Services Controller außer Betrieb. Weitere Informationen hierzu finden Sie unter Außerbetriebnahme des Platform Services Controller.
   Wichtig: Setzen Sie die Platform Services Controller-Instanzen erst außer Betrieb, nachdem Sie alle vCenter Server-Instanzen in Ihrer Topologie migriert und konvergiert haben.

Für eine aus zwei oder mehr vCenter Server- und Platform Services Controller-Instanzen bestehende Bereitstellung (eine M2xN2-Bereitstellung) müssen Sie zuerst die M1 vCenter Server-Instanz auf Version 8.0 und dann die zweite replizierende vCenter Server-Instanz migrieren.

1. Migrieren Sie den vCenter Server in Ihrer Topologie mithilfe der Vorlage win_vc_to_vCSA_on_ESXi.json bei der Migration auf ESXi oder mithilfe der Vorlage win_vc_to_vCSA_on_VC.json bei der Migration auf eine vCenter Server-Bereitstellung.

2. Bearbeiten Sie für die erste vCenter Server-Instanz ( M1) den Abschnitt sso der Vorlage so, dass der Parameter first_instance auf true festgelegt wird, und entfernen Sie den Parameter replication_partner_hostname.

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. Bearbeiten Sie für die verbleibende vCenter Server-Instanz ( M2) den Abschnitt sso der Vorlage so, dass der Parameter first_instance auf false festgelegt wird, und geben Sie den FQDN oder die IP-Adresse der vCenter Server-Instanz an, auf die Sie den zweiten Knoten replizieren möchten. Der Replizierungspartner ist die erste vCenter Server-Instanz ( M1), die Sie auf Version 8.0 migriert haben und die mit der zugehörigen Platform Services Controller-Instanz konvergiert wurde.

   "sso": {
   "__comments": [ This is the second instance (M2) vCenter Server management node, with "first_instance" set to "false" and "replication_partner_hostname" set to the hostname of the replication partner.],
   "first_instance": false,
   "replication_partner_hostname": "FQDN_or_IP_address"

4. Geben Sie die verbleibenden Konfigurationsparameter in den JSON-Vorlagen an und migrieren Sie vCenter Server mithilfe der CLI auf Version 8.0. Weitere Informationen hierzu finden Sie unter GUID-44148385-BDFE-4C67-BB35-C132D331BB8A.html#GUID-44148385-BDFE-4C67-BB35-C132D331BB8A.
5. Nachdem Sie alle vCenter Server-Instanzen in der Topologie erfolgreich migriert haben, müssen Sie die Platform Services Controller-Instanzen außer Betrieb setzen. Weitere Informationen hierzu finden Sie unter Außerbetriebnahme des Platform Services Controller.
   Wichtig: Setzen Sie die Platform Services Controller-Instanzen erst außer Betrieb, nachdem Sie alle vCenter Server-Instanzen in Ihrer Topologie migriert und konvergiert haben.

Konfigurationsparameter für die Migration

Wenn Sie das CLI-Installationsprogramm zur Migration Ihrer vCenter Server-Installation auf eine Appliance verwenden, müssen Sie die Parameter mit Werten für Ihre Migrationsspezifikation angeben.

In dieser Tabelle werden die Konfigurationsparameter aufgelistet, die Sie zur Bereitstellung von Eingabedaten für den Quell-vCenter Server verwenden.

Wichtig: Der Pfad zum vCenter Server Appliance-Installationsprogramm, der Pfad zu Ihrer JSON-Konfigurationsdatei und die Zeichenfolgenwerte in der JSON-Konfigurationsdatei, einschließlich der Kennwörter, dürfen nur ASCII-Zeichen enthalten. Erweiterte ASCII- und Nicht-ASCII-Zeichen werden nicht unterstützt.

Um einen Wert festzulegen, der einen umgekehrten Schrägstrich (\) oder ein Anführungszeichen (") enthält, müssen Sie dem Zeichen einen umgekehrten Schrägstrich (\) voranstellen. Beispiel: Mit "password":"my\"password" wird das Kennwort "mein Kennwort" und mit "image":"C:\\vmware\\vcsa" der Pfad C:\vmware\vcsa festgelegt.

Die booleschen Werte dürfen nur Kleinbuchstaben enthalten, d. h. ein Wert kann entweder true oder false sein. Beispiel: "ssh_enable":false.

Abschnitte und Unterabschnitte der Konfigurationsparameter in den JSON-Migrationsvorlagen

Die Konfigurationsparameter in den JSON-Migrationsvorlagen sind in Abschnitte und Unterabschnitte unterteilt.

Tabelle 2. Abschnitte und Unterabschnitte der Konfigurationsparameter in den JSON-Migrationsvorlagen

Abschnitt	Unterabschnitt	Beschreibung
new_vcsa - beschreibt die Ziel-Appliance, die Sie migrieren möchten.	esxi	Wird nur verwendet, wenn Sie die Appliance direkt auf einem ESXi-Host bereitstellen möchten. Enthält die Konfigurationsparameter, die den ESXi-Zielhost beschreiben. Hinweis: Sie müssen entweder den Unterabschnitt esxi oder den Unterabschnitt vc ausfüllen.
	vc	Wird nur verwendet, wenn Sie die Appliance im Bestand einer vCenter Server-Instanz bereitstellen möchten. Enthält die Konfigurationsparameter, die den ESXi-Zielhost oder den DRS-Cluster aus der vCenter Server-Bestandsliste beschreiben. Hinweis: Sie müssen entweder den Unterabschnitt vc oder den Unterabschnitt esxi ausfüllen.
	appliance	Enthält die Konfigurationsparameter, die die Appliance beschreiben.
	os	Enthält die Konfigurationsparameter, die die Betriebssystem-Einstellungen für die Appliance beschreiben.
	ovftool_arguments	Verwenden Sie diesen optionalen Unterabschnitt, um beliebige Argumente und ihre Werte zu dem vom Installationsprogramm generierten OVF Tool-Befehl hinzuzufügen. Wichtig: Das Installationsprogramm für die vCenter Server Appliance validiert die Konfigurationsparameter im Unterabschnitt ovftool_arguments nicht. Wenn Sie Argumente festlegen, die das OVF Tool nicht erkennt, schlägt die Bereitstellung möglicherweise fehl.
	temporary_network	Enthält die Konfigurationsparameter, die das temporäre Netzwerk für die Migration der Daten von der Quelle auf die neue Ziel-Appliance beschreiben.
	user-options	Verwenden Sie diese Parameter nur, wenn es sich bei der Quelle um eine vCenter Server-Instanz handelt. Enthält die Konfigurationsparameter, mit denen Sie Aspekte des Migrationsvorgangs für bestimmte Komponenten steuern.
source_vc - beschreibt den Quell-vCenter Server, das vCenter Single Sign-On oder den Platform Services Controller	vc_win	Enthält die Konfigurationsparameter, die die Windows-Quellinstallation von vCenter Server oder Platform Services Controller beschreiben.
	run_migration_assistant	Verwenden Sie diese Parameter nur, wenn die Windows-Quellinstallation als eine virtuelle Maschine ausgeführt wird und Sie das Aufrufen des Migrationsassistenten automatisieren möchten. Wenn eine Windows-Quellinstallation auf einer physischen Maschine ausgeführt wird oder wenn Sie den Migrationsassistenten auf der Windows-Quellmaschine manuell ausführen, kopieren Sie den Fingerabdruckwert aus der Ausgabe der Migrationsassistentenkonsole auf der Quellmaschine in denmigration_ssl_thumbprint-Schlüssel im vc_win-Unterabschnitt und entfernen Sie den run_migration_assistant-Abschnitt.
ceip: Beschreibt den Beitritt zum Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Programm, CEIP) von VMware.	settings	Enthält nur den Konfigurationsparameter ceip_enabled, um dem Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Program, CEIP) von VMware beizutreten oder nicht daran teilzunehmen. Nur erforderlich, wenn Sie eine vCenter Server-Appliance bereitstellen. Hinweis: Wenn der Konfigurationsparameter auf true festgelegt ist, müssen Sie den CLI-Bereitstellungsbefehl mit dem --acknowledge-ceip-Argument ausführen. Informationen über das CEIP finden Sie im Abschnitt „Konfigurieren des Programms zur Verbesserung der Benutzerfreundlichkeit“ in vCenter Server und Hostverwaltung.

Konfigurationsparameter im Abschnitt new_vcsa

Tabelle 3. Konfigurationsparameter im Abschnitt new_vcsa, Unterabschnitt esxi

Name	Typ	Beschreibung
hostname	string	Die IP-Adresse oder der FQDN des ESXi-Zielhosts, auf dem Sie die Appliance bereitstellen möchten.
username	string	Ein Benutzername mit Administratorrechten auf dem ESXi-Zielhost, zum Beispiel „root“.
password	string	Das Kennwort des Benutzers mit Administratorrechten auf dem ESXi-Zielhost.
deployment_network	string	Der Name des Netzwerks, mit dem die Appliance verbunden werden soll. Hinweis: Der Zugriff auf das Netzwerk muss über den ESXi-Zielhost erfolgen können. Wird ignoriert, wenn der ESXi-Zielhost nur über ein einziges Netzwerk verfügt.
datastore	string	Der Name des Datenspeichers, in dem Sie alle Konfigurationsdateien der virtuellen Maschine und die virtuellen Festplatten der Appliance speichern möchten. Hinweis: Der Zugriff auf den Datenspeicher muss über den ESXi-Host erfolgen können. Der Datenspeicher muss über ausreichend freien Speicherplatz verfügen.
port	integer	Die Portnummer des ESXi-Hosts. Der Standardport ist 443.
ssl_certificate_verification	string	Die CLI stellt sicher, dass das Sicherheitszertifikat eines Servers von einer Zertifizierungsstelle (CA) signiert wurde, und stellt eine sichere Verbindung her. Wenn das Zertifikat selbstsigniert ist, hält die CLI das Upgrade an, es sei denn, Sie geben eine der folgenden Konfigurationsoptionen für SSL-Zertifikat an. Geben Sie den Fingerabdruck des SHA-1-Zertifikats (Secure Hash Algorithm 1) an. Ein Fingerabdruck des Zertifikats ist eine hexadezimale Zeichenfolge, die ein Zertifikat eindeutig identifiziert. Der Fingerabdruck wird aus dem Inhalt des Zertifikats mit einem Fingerabdruckalgorithmus berechnet. "thumbprint": "Fingerabdruck des Zertifikats SHA-1" Legen Sie verification_mode auf NONE fest. "verification_mode": "NONE" Wenn Sie eine Verbindung zu einem Server mit selbstsigniertem Zertifikat herstellen und entweder den Fingerabdruck des SHA-1-Zertifikats nicht angeben oder den Überprüfungsmodus nicht auf NONE festlegen, zeigt die CLI den Fingerabdruck des selbstsignierten Zertifikats des Servers an und fordert Sie auf, den Fingerabdruck des Zertifikats zu akzeptieren oder abzulehnen. Sie können auch angeben, dass die CLI das selbstsignierte Zertifikat ignorieren soll. Verwenden Sie dazu den vcsa-deploy upgrade-Befehlsparameter --no-ssl-certificate-validation. Weitere Informationen hierzu finden Sie unter GUID-BD9CFD90-5C84-45A7-84AA-31660EB184F8.html#GUID-BD9CFD90-5C84-45A7-84AA-31660EB184F8.

Tabelle 4. Konfigurationsparameter im Abschnitt new_vcsa, Unterabschnitt vc

Name	Typ	Beschreibung
hostname	string	Die IP-Adresse oder der FQDN der vCenter Server-Zielinstanz, auf der Sie die Appliance bereitstellen möchten.
username	string	Benutzername des vCenter Single Sign-On-Administrators auf der vCenter Server-Zielinstanz, zum Beispiel „[email protected]“.
password	string	Das Kennwort des vCenter Single Sign-On-Administrators auf der vCenter Server-Zielinstanz.
deployment_network	string	Der Name des Netzwerks, mit dem die Appliance verbunden werden soll. Hinweis: Das Netzwerk muss über den ESXi-Zielhost oder den DRS-Cluster, auf bzw. in dem Sie die Appliance bereitstellen möchten, zugänglich sein. Wird ignoriert, wenn der ESXi-Zielhost oder der DRS-Cluster nur über ein einziges Netzwerk verfügt.
datacenter	string oder array	Das vCenter Server-Datencenter, das den ESXi-Zielhost oder den DRS-Cluster enthält, auf bzw. in dem Sie die Appliance bereitstellen möchten. Wenn sich das Datencenter in einem Ordner oder einer Ordnerstruktur befindet, muss der Wert entweder eine kommagetrennte Liste von Zeichenfolgen oder eine kommagetrennte Liste als einzelne Zeichenfolge sein. Beispiel: ["parent_folder", "child_folder", "datacenter_name"] oder "parent_folder, child_folder, datacenter_name" Wenn kein Ordnerpfad auf dem Datencenter besteht, verwenden Sie nur den Namen des Datencenters. Beispiel: ["datacenter_name"] oder "datacenter_name" Hinweis: Der Wert unterliegt der Groß-/Kleinschreibung.
datastore	string	Der Name des Datenspeichers, in dem Sie alle Konfigurationsdateien der virtuellen Maschine und die virtuellen Festplatten der Appliance speichern möchten. Hinweis: Der Zugriff auf den Datenspeicher muss über den ESXi-Zielhost oder den DRS-Cluster erfolgen können. Der Datenspeicher muss über mindestens 25 GB freien Speicherplatz verfügen.
port	integer	Die Portnummer des vCenter Server. Der Standardport ist 443.
target	string oder array	Der Zielcluster, ESXi-Host oder Ressourcenpool, auf dem Sie die neue Appliance bereitstellen möchten. Dies ist das Ziel, das Sie mit dem datacenter-Parameter angegeben haben. Dieser Pfad muss mit einem Clusternamen, ESXi-Hostnamen oder Ressourcenpoolnamen enden. Wichtig: Sie müssen den Namen angeben, der in der vCenter Server-Bestandsliste angezeigt wird. Wenn der Name des ESXi-Zielhosts beispielsweise eine IP-Adresse in der vCenter Server-Bestandsliste ist, können Sie keinen FQDN angeben. Hinweis: Bei allen Werten wird die Groß-/Kleinschreibung beachtet. Wenn Sie die bereitgestellte Appliance an einem anderen Speicherort innerhalb der Hierarchie des Datencenters listen möchten, verwenden Sie den weiter unten in diesem Abschnitt beschriebenen Parameter vm_folder. Wenn sich der Zielcluster, der ESXi-Host oder der Ressourcenpool in einem Ordner oder einer Ordnerstruktur befindet, muss der Wert entweder eine kommagetrennte Liste von Zeichenfolgen oder eine kommagetrennte Liste als einzelne Zeichenfolge sein. Beispiel: ["parent_folder", "child_folder", "esxi-host.domain.com"] oder "parent_folder, child_folder, esxi-host.domain.com" Wenn der ESXi-Zielhost Teil eines Clusters ist, verwenden Sie zur Angabe des Pfads eine kommagetrennte Liste von Zeichenfolgen oder eine kommagetrennte Liste als einzelne Zeichenfolge. Beispiel: ["cluster_name", "esxi-host.domain.com"] oder "cluster_name, esxi-host.domain.com" Bei der Bereitstellung in einem Ressourcenpool müssen Sie dem Ressourcenpoolnamen die Bezeichnung Resources voranstellen. Beispiel: ["cluster_name", "Resources", "resource_pool_name"] Hinweis: Bei Vorabprüfungen wird nur der Speicher des Ressourcenpools überprüft.
vm_folder	string	Optional. Der Name des VM-Ordners, dem die Appliance hinzugefügt werden soll.

Tabelle 5. Konfigurationsparameter im Abschnitt new_vcsa, Unterabschnitt appliance

Name	Typ	Beschreibung
thin_disk_mode	Boolean	Legen Sie diesen Parameter auf true fest, um die virtuelle Appliance mit schnellen virtuellen Festplatten bereitzustellen.
deployment_option	string	Die Größe der Appliance. Legen Sie diesen Parameter auf tiny fest, wenn Sie eine vCenter Server Appliance für bis zu 10 Hosts und 100 virtuelle Maschinen mit Standardspeichergröße bereitstellen möchten. Stellt eine Appliance mit 2 CPUs, 10 GB Arbeitsspeicher und 300 GB Speicher bereit. Legen Sie diesen Parameter auf tiny-lstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 10 Hosts und 100 virtuelle Maschinen mit großem Speicher bereitstellen möchten. Stellt eine Appliance mit 2 CPUs, 10 GB Arbeitsspeicher und 825 GB Speicher bereit. Legen Sie diesen Parameter auf tiny-xlstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 10 Hosts und 100 virtuelle Maschinen mit sehr großem Speicher bereitstellen möchten. Stellt eine Appliance mit 2 CPUs, 10 GB Arbeitsspeicher und 1700 GB Speicher bereit. Legen Sie diesen Parameter auf small fest, wenn Sie eine vCenter Server Appliance für bis zu 100 Hosts und 1.000 virtuelle Maschinen mit Standardspeichergröße bereitstellen möchten. Stellt eine Appliance mit 4 CPUs, 16 GB Arbeitsspeicher und 340 GB Speicher bereit. Legen Sie diesen Parameter auf small-lstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 100 Hosts und 1.000 virtuelle Maschinen mit großem Speicher bereitstellen möchten. Stellt eine Appliance mit 4 CPUs, 16 GB Arbeitsspeicher und 870 GB Speicher bereit. Legen Sie diesen Parameter auf small-xlstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 100 Hosts und 1.000 virtuelle Maschinen mit sehr großem Speicher bereitstellen möchten. Stellt eine Appliance mit 4 CPUs, 16 GB Arbeitsspeicher und 1750 GB Speicher bereit. Legen Sie diesen Parameter auf medium fest, wenn Sie eine vCenter Server Appliance für bis zu 400 Hosts und 4.000 virtuelle Maschinen mit Standardspeichergröße bereitstellen möchten. Stellt eine Appliance mit 8 CPUs, 24 GB Arbeitsspeicher und 525 GB Speicher bereit. Legen Sie diesen Parameter auf medium-lstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 400 Hosts und 4.000 virtuelle Maschinen mit großem Speicher bereitstellen möchten. Stellt eine Appliance mit 8 CPUs, 24 GB Arbeitsspeicher und 1025 GB Speicher bereit. Legen Sie diesen Parameter auf medium-xlstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 400 Hosts und 4.000 virtuelle Maschinen mit sehr großem Speicher bereitstellen möchten. Stellt eine Appliance mit 8 CPUs, 24 GB Arbeitsspeicher und 1905 GB Speicher bereit. Legen Sie diesen Parameter auf large fest, wenn Sie eine vCenter Server Appliance für bis zu 1.000 Hosts und 10.000 virtuelle Maschinen mit Standardspeichergröße bereitstellen möchten. Stellt eine Appliance mit 16 CPUs, 32 GB Arbeitsspeicher und 740 GB Speicher bereit. Legen Sie diesen Parameter auf large-lstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 1.000 Hosts und 10.000 virtuelle Maschinen mit großem Speicher bereitstellen möchten. Stellt eine Appliance mit 16 CPUs, 32 GB Arbeitsspeicher und 1090 GB Speicher bereit. Legen Sie diesen Parameter auf large-xlstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 1.000 Hosts und 10.000 virtuelle Maschinen mit sehr großem Speicher bereitstellen möchten. Stellt eine Appliance mit 16 CPUs, 32 GB Arbeitsspeicher und 1970 GB Speicher bereit. Legen Sie diesen Parameter auf xlarge fest, wenn Sie eine vCenter Server Appliance für bis zu 2.000 Hosts und 35.000 virtuelle Maschinen mit Standardspeichergröße bereitstellen möchten. Stellt eine Appliance mit 24 CPUs, 48 GB Arbeitsspeicher und 1180 GB Speicher bereit. Legen Sie diesen Parameter auf xlarge-lstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 2.000 Hosts und 35.000 virtuelle Maschinen mit großem Speicher bereitstellen möchten. Stellt eine Appliance mit 24 CPUs, 48 GB Arbeitsspeicher und 1230 GB Speicher bereit. Legen Sie diesen Parameter auf xlarge-xlstorage fest, wenn Sie eine vCenter Server Appliance für bis zu 2.000 Hosts und 35.000 virtuelle Maschinen mit sehr großem Speicher bereitstellen möchten. Stellt eine Appliance mit 24 CPUs, 48 GB Arbeitsspeicher und 2110 GB Speicher bereit.
image	string	Optional. Ein lokaler Dateipfad oder eine URL für das Installationspaket der vCenter Server Appliance. Standardmäßig verwendet das Installationsprogramm das in der ISO-Datei im Ordner vcsa enthaltene Installationspaket.
name	string	Der VM-Name für die Appliance. Darf mit Ausnahme des Prozentsymbols (%), des umgekehrten Schrägstrichs (\) und des Schrägstrichs (/) nur ASCII-Zeichen enthalten und maximal 80 Zeichen umfassen.
ovftool_path	string	Optional. Ein lokaler Dateipfad für die ausführbare Datei des OVF Tools. Standardmäßig verwendet das Installationsprogramm die in der ISO-Datei im Ordner vcsa/ovftool enthaltene Instanz des OVF Tools.

Tabelle 6. Konfigurationsparameter im Abschnitt new_vcsa, Unterabschnitt os

Name	Typ	Beschreibung
password	string	Das Kennwort für den Root-Benutzer des Appliance-Betriebssystems. Das Kennwort muss zwischen 8 und 20 Zeichen lang sein und mindestens einen Großbuchstaben, einen Kleinbuchstaben, eine Zahl und ein Sonderzeichen wie beispielsweise ein Dollarzeichen ($), ein Rautesymbol (#), ein at-Zeichen (@), einen Punkt (.) oder ein Ausrufezeichen (!) enthalten. Alle Zeichen müssen Zeichen des unteren ASCII-Satzes ohne Leerzeichen sein.
ssh_enable	Boolean	Dieser Parameter wird auf true gesetzt, um die SSH-Administratoranmeldung für die Appliance zu aktivieren.

Tabelle 7. Konfigurationsparameter im Abschnitt new_vcsa, Unterabschnitt temporary_network

Name	Typ	Beschreibung
ip_family	string	IP-Version für das Netzwerk der Appliance. Legen Sie diesen Parameter auf ipv4 oder ipv6 fest.
mode	string	IP-Zuweisung für das Netzwerk der Appliance. Legen Sie diesen Parameter auf static oder dhcp fest.
ip	string	IP-Adresse für die Appliance. Nur erforderlich, wenn die statische Zuweisung verwendet wird, d. h., wenn Sie den Parameter mode auf static festlegen. Sie müssen eine IPv4- oder IPv6-Adresse festlegen, die der IP-Version des Netzwerks entspricht, d. h. Sie müssen sie auf den Wert des Parameters ip_family festlegen. Eine IPv4-Adresse muss den RFC 790-Richtlinien entsprechen. Eine IPv6-Adresse muss den RFC 2373-Richtlinien entsprechen.
dns_servers	string oder array	IP-Adressen von einem oder mehreren DNS-Servern. Um mehrere DNS-Server festzulegen, verwenden Sie zur Angabe des Pfads eine kommagetrennte Liste von Zeichenfolgen oder eine kommagetrennte Liste als einzelne Zeichenfolge. Beispiel: ["x.y.z.a", "x.y.z.b"] oder "x.y.z.a, x.y.z.b" Nur erforderlich, wenn die statische Zuweisung verwendet wird, d. h., wenn Sie den Parameter mode auf static festlegen.
prefix	string	Präfixlänge des Netzwerks. Nur erforderlich, wenn die Zuweisung verwendet wird, d. h., wenn Sie den Parameter mode auf static festlegen. Für IPv4 muss der Wert zwischen 0 und 32 liegen. Für IPv6 muss der Wert zwischen 0 und 128 liegen.
gateway	string	IP-Adresse des Standard-Gateways. Für IPv6 kann der Wert default sein.

Tabelle 8. Konfigurationsparameter im Abschnitt new_vcsa, Unterabschnitt user_options

Name	Typ	Beschreibung
vcdb_migrateSet	string	Wählen Sie die Datentypen aus, die von der alten Appliance auf die neue Appliance migriert werden sollen. Die Daten werden vom Quell-vCenter Server auf den Zielserver kopiert. Die ursprüngliche Quelle der Daten bleibt unverändert. Legen Sie diesen Parameter auf core fest, wenn nur die Konfigurationsdaten übertragen werden sollen. Dies stellt die schnellste Datenmigration dar; die Systemausfallzeit wird auf ein Minimum beschränkt. Legen Sie diesen Parameter auf core_events_tasks fest, wenn die Konfigurations- und Verlaufsdaten (Ereignisse und Aufgaben) sofort übertragen werden sollen. vCenter Server wird erst gestartet, wenn alle Daten vom Quell-vCenter Server für Windows migriert wurden. Legen Sie diesen Parameter auf all fest, wenn die Konfigurations-, Verlaufs- und Leistungsdaten sofort übertragen werden sollen. vCenter Server wird erst gestartet, wenn alle Daten vom Quell-vCenter Server für Windows migriert wurden. Diese Option überträgt die größte Menge an Daten und erfordert eine längere Ausfallzeit als andere Optionen zur Datenmigration. Legen Sie diesen Parameter auf transfer_events_tasks_after_upgrade fest, wenn Sie die Verlaufsdaten (Ereignisse und Aufgaben) nach Abschluss des Upgrades im Hintergrund übertragen möchten. Während dieser Zeit ist die Leistung von vCenter Server unter Umständen nicht optimal. Legen Sie diesen Parameter auf transfer_stats_events_tasks_after_upgrade fest, wenn Sie Verlaufs- und Leistungsdaten nach Abschluss des Upgrades im Hintergrund übertragen möchten. Während dieser Zeit ist die Leistung von vCenter Server unter Umständen nicht optimal. Hinweis: Um die Migrationsdauer und den Speicherbedarf für die neue vCenter Server Appliance auf ein Minimum zu begrenzen, verwenden Sie den Wert core. Weitere Informationen zu den Arten von Daten, die Sie von Ihrem vorhandenen vCenter Server auf den neuen, aktualisierten vCenter Server übertragen können, finden Sie unter GUID-B644A230-8AAB-4B27-B5F4-0EA1C6527CD3.html#GUID-B644A230-8AAB-4B27-B5F4-0EA1C6527CD3.

Tabelle 9. Konfigurationsparameter im Abschnitt new_vcsa, Unterabschnitt sso

Name	Typ	Beschreibung
first_instance	string	Legen Sie first_instance auf true fest, wenn dies der erste Konvergenz-Migrationsvorgang in Ihrer vCenter Server SSO-Domäne ist oder wenn Sie den Replizierungspartner für diesen Knoten nicht festlegen möchten. Wenn Sie den Replizierungspartner für diesen Knoten festlegen möchten, legen Sie first_instance auf false fest und geben Sie den Wert für replication_partner_hostname als FQDN eines zuvor konvergierten Knotens an, der sich aktuell in einer eingebetteten vCenter Server-Topologie befindet. Weitere Informationen zur Angabe der Parameter first_instance und replication_partner_hostname finden Sie unter GUID-8C104853-3152-47B5-8215-5946CB39BCE3.html#GUID-8C104853-3152-47B5-8215-5946CB39BCE3.
replication_partner_hostname	string	Hostname des Replizierungspartners. Entfernen Sie ihn, wenn es sich um den first_instance handelt

Anforderungen für das automatische Aufrufen des Migrationsassistenten

Sie verwenden den run_migration_assistant-Unterabschnitt, um das Aufrufen des Migrationsassistenten zu automatisieren. Das automatische Aufrufen funktioniert nur, wenn die Windows-Quellinstallation als eine virtuelle Maschine ausgeführt wird.

Für das von Ihnen in den Parametern os_username oder vum_os_username festgelegte Benutzerkonto ist eine Erhöhung der Rechte auf Administratorrechte erforderlich. Beispiel:

• Das integrierte Windows-Administratorkonto.
• Ein Benutzerkonto mit einem Benutzernamen, der nicht „Administrator“ lautet und der Mitglied der lokalen Windows-Administratorgruppe ist.
• Das Konto „Domänenadministrator“ mit dem Benutzernamen „Administrator“, das Mitglied der lokalen Windows-Administratorgruppe ist.
• Die Benutzernamen-ID muss im Format ihr_domaenenname\\benutzer_ID oder benutzer_ID@ihr_domaenenname angegeben werden.

Einschränkung: Das automatische Aufrufen des Migrationsassistenten funktioniert nicht mit einem Windows-Konto, für das eine Erhöhung der Rechte auf Administratorrechte erforderlich ist. Führen Sie stattdessen den Migrationsassistenten manuell auf dem Windows-Quellcomputer aus. Kopieren Sie den Fingerabdruckwert aus der Konsolenausgabe des Migrationsassistenten auf der Quellmaschine in den migration_ssl_thumbprint-Schlüssel im Unterabschnitt vc_win, fügen Sie ihn ein und entfernen Sie den Abschnitt run_migration_assistant.

Konfigurationsparameter im Abschnitt source_vc

Tabelle 10. Konfigurationsparameter im Abschnitt source_vc, Unterabschnitt vc_win

Name	Typ	Beschreibung
hostname	string	Der Hostname oder die IP-Adresse der Windows-Quellinstallation von vCenter Server oder Platform Services Controller, die Sie migrieren möchten.
username	string	Ein vCenter Single Sign-On-Benutzername mit Administratorrechten für die vCenter Server-, vCenter Single Sign-On- oder Platform Services Controller-Instanz, die Sie migrieren möchten.
password	string	Das Kennwort der vCenter Server- oder Platform Services Controller-Instanz, die Sie migrieren möchten.
migration_port	string	Die Portnummer des Migrationsassistenten wird auf der Konsole des Migrationsassistenten angezeigt. Der Standardport lautet 9123.
active_directory_domain	string	Der Name der Active Directory-Domäne, zu der die vCenter Server-Quellinstanz hinzugefügt wird.
active_directory_username	string	Administrator-Benutzername der Active Directory-Domäne, zu der die vCenter Server-Instanz hinzugefügt wird.
active_directory_password	string	Administratorkennwort der Active Directory-Domäne, zu der die vCenter Server-Instanz hinzugefügt wird. Hinweis: Das Installationsprogramm überprüft die eingegebenen Anmeldedaten, aber nicht die erforderlichen Berechtigungen zum Hinzufügen der Zielmaschine zur Active Directory-Domäne. Stellen Sie sicher, dass die Benutzeranmeldedaten über die erforderlichen Berechtigungen zum Hinzufügen einer Maschine zur Active Directory-Domäne verfügen.
migration_ssl_thumbprint	string	Der SSL-Fingerabdruck des Migrationsassistenten.

Tabelle 11. Konfigurationsparameter im Abschnitt source_vc, Unterabschnitt run_migration_assistant

Name	Typ	Beschreibung
esxi_hostname	string	FQDN oder IP-Adresse von ESXi, auf dem sich die vCenter Server-Quell-, vCenter Single Sign-On- oder Platform Services Controller-Instanz befindet.
esxi_username	string	Benutzername eines Benutzers mit Administratorrechten auf dem ESXi-Host.
esxi_password	string	Das Kennwort des ESXi-Hostbenutzers. Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts an der Befehlskonsole aufgefordert.
esxi_port	string	Die Portnummer des ESXi-Hosts. Der Standardport ist 443.
os_username	string	Administrator-Benutzername für die Windows-Quellmaschine.
os_password	string	Administrator-Benutzerkennwort für die Windows-Quellmaschine. Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe an der Befehlskonsole aufgefordert.
migration_ip	string	Die IP-Adresse des Netzwerkadapters, der migriert wird.
migration_port	string	Die Portnummer des Migrationsassistenten wird auf der Konsole des Migrationsassistenten angezeigt. Der Standardport lautet 9123.
export_dir	string	Verzeichnis für den Export von Quelldaten und -konfiguration.
sa_password	string	Die IP-Adresse des Benutzerkennworts für das vCenter Server-Dienstkonto im Netzwerk. Diese Option ist nur erforderlich, wenn der vCenter Server-Dienst über ein Konto ausgeführt wird, bei dem es sich nicht um das lokale Systemkonto handelt. Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe an der Befehlskonsole aufgefordert.

Tabelle 12. Konfigurationsparameter im Abschnitt source_vum, Unterabschnitt run_migration_assistant

Name	Typ	Beschreibung
esxi_hostname	string	FQDN oder IP-Adresse von ESXi, auf dem sich die vCenter Server-Quell-, vCenter Single Sign-On- oder Platform Services Controller-Instanz befindet.
esxi_username	string	Benutzername eines Benutzers mit Administratorrechten auf dem ESXi-Host.
esxi_password	string	Das Kennwort des ESXi-Hostbenutzers. Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts an der Befehlskonsole aufgefordert.
esxi_port	string	Die Portnummer des ESXi-Hosts. Der Standardport ist 443.
vum_hostname	string	FQDN oder IP-Adresse von ESXi, auf dem sich die Update Manager-Quellinstanz befindet.
vum_os_username	string	Administrator-Benutzername für die Windows-Quellmaschine.
vum_os_password	string	Administrator-Benutzerkennwort für die Windows-Quellmaschine für Update Manager. Wenn Sie dies auslassen, werden Sie während der Vorlagenüberprüfung zur Eingabe an der Befehlskonsole aufgefordert.
migration_port	string	Die Portnummer des Migrationsassistenten wird auf der Konsole des Migrationsassistenten angezeigt. Der Standardport lautet 9123.
export_dir	string	Verzeichnis für den Export von Quelldaten und -konfiguration.

Konfigurationsparameter im Abschnitt ceip

Tabelle 13. Konfigurationsparameter im Abschnitt ceip, Unterabschnitt settings

Name	Typ	Beschreibung
ceip_enabled	Boolean	Setzen Sie den Parameter auf true, um dem CEIP für diese Appliance beizutreten.

Ausführen einer Vorabprüfung vor einer CLI-Migration zur vCenter Server Appliance

Sie können eine Vorabprüfung ausführen, um sicherzustellen, dass die Migrationsanforderungen erfüllt sind, und um mögliche Probleme vor der Migration Ihrer vCenter Server-Bereitstellung zu beheben.

Bevor Sie Ihre vCenter Server-Bereitstellung zu einer Appliance migrieren, können Sie eine Vorabprüfung ausführen, um die Festplattenspeicheranforderungen, die geschätzte Dauer für das Upgrade und die bei der vCenter Server Appliance registrierten Erweiterungen zu ermitteln. Das Ausführen einer Vorabprüfung ist ein optionaler, aber dringend empfohlener Schritt beim Planen des Upgrades.

Voraussetzungen

GUID-9E0F567C-BA00-42D5-AC74-8497BDC61192.html#GUID-9E0F567C-BA00-42D5-AC74-8497BDC61192 unter Verwendung der Beispielvorlagen und Konfigurationsparameter.

Prozedur

1. Überprüfen Sie Ihre Vorlage, ohne die Appliance bereitzustellen, indem Sie den folgenden Befehl eingeben: vcsa-deploy migrate --verify-template-only Pfad_zur_JSON-Datei.
2. Führen Sie CLI Migrate unter Verwendung der --precheck-only-Option aus.
   Sie können Ihre Migrationspläne anhand der Festplattenspeicheranforderungen und der geschätzten Migrationsdauer anpassen. Wird eine Fehlermeldung angezeigt, können Sie das Problem vor der eigentlichen Migration beheben.
3. Nachdem Sie alle potenziellen Fehler beseitigt haben, führen Sie den Befehl CLI Migrate erneut unter Verwendung der Option --verify-template-only aus, bis alle Fehler behoben sind.

Ergebnisse

Jetzt sind Sie bereit für eine fehlerfreie CLI-Migration.

Nächste Maßnahme

GUID-44148385-BDFE-4C67-BB35-C132D331BB8A.html#GUID-44148385-BDFE-4C67-BB35-C132D331BB8A.

Durchführen einer CLI-Migration von vCenter Server von Windows zu einer Appliance

Sie können vCenter Server von einer Maschine in Ihrem vSphere-Netzwerk zu einer Appliance migrieren.

Voraussetzungen

• Siehe Voraussetzungen für die Migration von vCenter Server.
• Erstellen Sie einen Snapshot der Bereitstellung, die migriert werden soll, als Vorsichtsmaßnahme für den Fall, dass während des Migrationsvorgangs ein Fehler auftritt.
• Laden Sie die ISO-Installationsdatei von der VMware-Website auf eine Maschine in Ihrem vSphere-Netzwerk herunter. Der Name der ISO-Installationsdatei lautet VMware-VCSA-all-8.0.0-yyyyyy.iso, wobei yyyyyy der Build-Nummer entspricht. Weitere Informationen hierzu finden Sie unter GUID-11468F6F-0D8C-41B1-82C9-29284630A4FF.html#GUID-11468F6F-0D8C-41B1-82C9-29284630A4FF.
• GUID-9E0F567C-BA00-42D5-AC74-8497BDC61192.html#GUID-9E0F567C-BA00-42D5-AC74-8497BDC61192.
• GUID-2F4C94BA-3C77-48F2-9D22-053187BA7BC1.html#GUID-2F4C94BA-3C77-48F2-9D22-053187BA7BC1, um Probleme zu ermitteln und Ihren Migrationsplan zu optimieren.
• Überprüfen Sie die optionalen Argumente für das Ausführen der Migration Weitere Informationen hierzu finden Sie unter GUID-BD9CFD90-5C84-45A7-84AA-31660EB184F8.html#GUID-BD9CFD90-5C84-45A7-84AA-31660EB184F8.

Prozedur

1. Navigieren Sie zum Verzeichnis des Software-Installationsprogramms für Ihr Betriebssystem.
   • Wenn Sie die Appliance von einem Computer mit Windows-Betriebssystem aus bereitstellen, navigieren Sie zum Verzeichnis vcsa-cli-installer\win32.
   • Wenn Sie die Appliance von einem Computer mit Linux-Betriebssystem aus bereitstellen, navigieren Sie zum Verzeichnis vcsa-cli-installer/lin64.
   • Wenn Sie die Appliance von einem Computer mit Mac-Betriebssystem aus bereitstellen, navigieren Sie zum Verzeichnis vcsa-cli-installer/mac.
2. Wählen Sie das Software-Installationsprogramm aus: vcsa-deploy.exe.
3. Führen Sie den Migrationsbefehl aus.

   vcsa-deploy migrate --accept-eula optional_arguments path_to_the_json_file

   Bei der Variable optional_arguments handelt es sich um eine durch Leerzeichen getrennte Liste von Argumenten für das Vornehmen zusätzlicher Konfigurationen.
   Sie können beispielsweise den Speicherort der Protokolldateien sowie weiterer Ausgabedateien festlegen, die das Installationsprogramm generiert.

   vcsa-deploy migrate --accept-eula --log-dir=path_to_the_location path_to_the_json_file

Ergebnisse

Die Migrationsvorlage wird bereitgestellt. Führen Sie die Schritte unter Sicherstellen, dass das Upgrade oder die Migration der vCenter Server erfolgreich ist aus.

Syntax des CLI-Migrierbefehls

Mithilfe von einem oder mehreren Befehlsargumenten können Sie die Ausführungsparameter des Migrierbefehls festlegen.

Sie können dem CLI-Upgrade-Befehl eine durch Leerzeichen getrennte Liste von Argumenten hinzufügen.

vcsa-deploy migrate list_of_arguments path_to_the_json_file

Das erforderliche template-Argument stellt den Pfad einer JSON-Datei bereit, die das Bereitstellungsverfahren für die vCenter Server Appliance beschreibt. Sie können mehrere JSON-Dateien in einem Verzeichnis speichern. Die CLI migriert alle Bereitstellungen im Batch-Modus. Weitere Informationen zur Durchführung gleichzeitiger Migrationen finden Sie unter GUID-9E0F567C-BA00-42D5-AC74-8497BDC61192.html#GUID-9E0F567C-BA00-42D5-AC74-8497BDC61192.

Wichtig: Die Zeichenfolgenwerte, einschließlich der Kennwörter, dürfen nur ASCII-Zeichen enthalten. Erweiterte ASCII- und Nicht-ASCII-Zeichen werden nicht unterstützt.

Um einen Wert festzulegen, der einen umgekehrten Schrägstrich (\) oder ein Anführungszeichen (") enthält, müssen Sie dem Zeichen einen umgekehrten Schrägstrich (\) voranstellen. Beispiel: Mit "password":"my\"password" wird das Kennwort "mein Kennwort" und mit "image":"C:\\vmware\\vcsa" der Pfad C:\vmware\vcsa festgelegt.

Die booleschen Werte dürfen nur Kleinbuchstaben enthalten, d. h. ein Wert kann entweder true oder false sein. Beispiel: "ssh.enable":false.

Optionales Argument	Beschreibung
--accept-eula	Akzeptiert die Endbenutzer-Lizenzvereinbarung. Erforderlich für die Ausführung des Bereitstellungsbefehls.
-h, --help	Zeigt die Hilfemeldung zu dem Befehl an.
--template-help	Zeigt die Hilfemeldung zu den Konfigurationsparametern in der JSON-Bereitstellungsdatei an. Mit vcsa-deploy [subcommand] --help können Sie eine Liste unterbefehlsspezifischer Argumente aufrufen.
-v, --verbose	Fügt der Konsolenausgabe Debug-Informationen hinzu.
-t, --terse	Blendet die Konsolenausgabe aus. Zeigt nur Warn- und Fehlermeldungen an.
--log-dir, LOG_DIR	Legt den Speicherort der Protokolldateien sowie weiterer Ausgabedateien fest, die das Installationsprogramm generiert.
--skip-ovftool-verification	Führt die grundlegende Überprüfung der Konfigurationsparameter durch und stellt die vCenter Server-Appliance bereit, validiert jedoch nicht die OVF-Tool-Parameter im Unterabschnitt ovftool_arguments der JSON-Vorlage. Wenn Sie Argumente festlegen, die das OVF Tool nicht erkennt, schlägt die Bereitstellung möglicherweise fehl.
--no-ssl-certificate-verification	Verbietet die SSL-Überprüfung von ESXi-Verbindungen. Die CLI stellt sicher, dass das Sicherheitszertifikat eines Servers von einer Zertifizierungsstelle (CA) signiert wurde, und stellt eine sichere Verbindung her. Wenn das Zertifikat selbstsigniert ist, hält die CLI das Upgrade an, es sei denn, Sie legen mit dem Befehlsparameter --no-ssl-certificate-validation fest, dass die Befehlszeilenschnittstelle das selbstsignierte Zertifikat ignorieren soll. Wenn Sie eine Verbindung zu einem Server mit einem selbstsignierten Zertifikat herstellen und nicht angeben, dass die CLI es akzeptiert, zeigt die CLI den Fingerabdruck des selbstsignierten Zertifikats des Servers an und fordert Sie auf, es anzunehmen oder abzulehnen. Sie können auch festlegen, dass die CLI selbstsignierte Zertifikate ignoriert, indem Sie den Konfigurationsparameter ssl_certificate_verification in der JSON-Vorlage verwenden. Weitere Informationen hierzu finden Sie unter GUID-7DB7945F-698F-4954-9320-3AA80B6E9ABA.html#GUID-7DB7945F-698F-4954-9320-3AA80B6E9ABA. Wichtig: Vermeiden Sie diese Option, da sie Probleme während oder nach dem Upgrade aufgrund einer nicht validierten Identität des Zielhosts verursachen kann.
--operation-id	Dadurch können Sie eine Kennung angeben, um die parallele Installation, Migration oder Aktualisierung von mehreren vCenter Server-Instanzen nachzuverfolgen. Wenn Sie keine Vorgangs-ID angeben, generiert die CLI eine UUID (universell eindeutige Kennung), mit der Sie die verschiedenen Instanzen von vCenter Server und deren Installations- bzw. Upgrade-Status identifizieren können.
--verify-template-only	Führt eine grundlegende Vorlagenüberprüfung durch, ohne Upgrade Runner zu installieren, Vorabprüfungen auszuführen oder die vCenter Server Appliance zu aktualisieren oder zu migrieren.
--precheck-only	Installiert den Migrationsassistenten auf der virtuellen vCenter Server-Quellmaschine und führt einen vollständigen Satz von Vorabprüfungen aus, ohne die Migration durchzuführen.
--acknowledge-ceip	Bestätigt Ihre Zustimmung zur Teilnahme am Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Program, CEIP) von VMware. Dieses Argument ist Pflicht, wenn ceip.enabled in der Upgrade-Vorlage auf „true“ gesetzt ist.

Exit-Code	Beschreibung
0	Befehl wurde erfolgreich ausgeführt
1	Laufzeitfehler
2	Validierungsfehler
3	Vorlagenfehler