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.
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.
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 von
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-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 bei Bereitstellung einer vCenter Server Appliance mit eingebettetem Platform Services Controller oder einer Platform Services Controller-Appliance.
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
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": "certificate SHA-1 thumbprint" Legen Sie "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 Sie können auch angeben, dass die CLI das selbstsignierte Zertifikat ignorieren soll. Verwenden Sie dazu den vcsa-deploy upgrade-Befehlsparameter |
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
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 unten 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, zu dem die Appliance hinzugefügt werden soll. |
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.
|
image |
string | Optional. Ein lokaler Dateipfad oder eine URL für das vCenter Server Appliance-Installationspaket. 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. |
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. |
Name | Typ | Beschreibung |
---|---|---|
ip_family |
string | IP-Version für das Netzwerk der Appliance. Legen Sie diesen Parameter auf |
mode |
string | IP-Zuweisung für das Netzwerk der Appliance. Legen Sie diesen Parameter auf |
ip |
string | IP-Adresse für die Appliance. Nur erforderlich, wenn die statische Zuweisung verwendet wird, d. h., wenn Sie den Parameter 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 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 |
prefix |
string | Präfixlänge des Netzwerks. Nur erforderlich, wenn die Zuweisung verwendet wird, d. h., wenn Sie den Parameter Für IPv4 muss der Wert zwischen Für IPv6 muss der Wert zwischen |
gateway |
string | IP-Adresse des Standard-Gateways. Für IPv6 kann der Wert |
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.
Hinweis: Um die Migrationsdauer und den Speicherbedarf für die neue vCenter Server-Appliance auf ein Minimum zu begrenzen, müssen Sie den Wert
core verwenden.
Weitere Informationen zu den Arten von Daten, die Sie von Ihrem vorhandenen auf den neuen, aktualisierten vCenter Server übertragen können, finden Sie unter Übertragen von Daten von einer vorhandenen vCenter Server Appliance. |
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.
os_username
- oder
vum_os_username
-Parametern 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 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.
migration_ssl_thumbprint
-Schlüssel im
vc_win
-Unterabschnitt, fügen Sie ihn ein und entfernen Sie den
run_migration_assistant
-Abschnitt.
Konfigurationsparameter im Abschnitt source_vc
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 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. |
Name | Typ | Beschreibung |
---|---|---|
esxi_hostname |
string | FQDN oder IP-Adresse von ESXi, auf dem sich die vCenter Server Platform Services Controller-Quellinstanz befindet. |
esxi_username |
string | Benutzername eines Benutzers mit Administratorrechten auf dem ESXi-Host. |
esxi_password |
string | Das Kennwort des ESXi-Hostbenutzers. Sofern nicht angegeben oder ausgelassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei 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. Sofern nicht angegeben oder ausgelassen, werden Sie während der Vorlagenüberprüfung dessen Eingabe bei 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. Sofern nicht angegeben oder ausgelassen, werden Sie während der Vorlagenüberprüfung dessen Eingabe bei der Befehlskonsole aufgefordert. |
Name | Typ | Beschreibung |
---|---|---|
esxi_hostname |
string | FQDN oder IP-Adresse von ESXi, auf dem sich die vCenter Server Platform Services Controller-Quellinstanz befindet. |
esxi_username |
string | Benutzername eines Benutzers mit Administratorrechten auf dem ESXi-Host. |
esxi_password |
string | Das Kennwort des ESXi-Hostbenutzers. Sofern nicht angegeben oder ausgelassen, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei 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. Sofern nicht angegeben oder ausgelassen, werden Sie während der Vorlagenüberprüfung dessen Eingabe bei 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
Name | Typ | Beschreibung |
---|---|---|
ceip_enabled |
Boolean | Setzen Sie den Parameter auf true , um dem CEIP für diese Appliance beizutreten. |