Wenn Sie die JSON-Konfigurationsdateien für das CLI-Upgrade vorbereiten, müssen Sie Parameter und Werte festlegen, um Eingabedaten für das Upgrade einer vCenter Server Appliance oder einer Platform Services Controller-Appliance bereitzustellen.
Abschnitte und Unterabschnitte der Konfigurationsparameter in den JSON-Upgrade-Dateien
Die Konfigurationsparameter in den JSON-Konfigurationsdateien für ein CLI-Upgrade sind in Abschnitte und Unterabschnitte unterteilt.
Abschnitt | Unterabschnitt | Beschreibung |
---|---|---|
new_vcsa - beschreibt die neue Appliance, die Sie bereitstellen möchten. |
esxi |
Wird nur verwendet, wenn Sie die neue Appliance direkt auf einem ESXi-Host bereitstellen möchten.
Enthält die Konfigurationsparameter, die den
ESXi-Zielhost beschreiben. Weitere Informationen hierzu finden Sie unter
Konfigurationsparameter im Abschnitt new_vcsa , Unterabschnitt esxi .
Hinweis: Sie müssen entweder diesen Unterabschnitt oder den Unterabschnitt
vc eingeben.
|
vc |
Wird nur verwendet, wenn Sie die neue 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. Weitere Informationen hierzu finden Sie unter Konfigurationsparameter im Abschnitt
Hinweis: Sie müssen entweder diesen Unterabschnitt oder den Unterabschnitt
esxi eingeben.
Die vCenter Server-Zielinstanz kann nicht die vCenter Server Appliance sein, für die Sie das Upgrade durchführen möchten. Verwenden Sie in diesen Fällen den Unterabschnitt |
|
appliance |
Enthält die Konfigurationsparameter, die die neue Appliance beschreiben. Siehe Konfigurationsparameter im Abschnitt new_vcsa , Unterabschnitt appliance . |
|
os |
Enthält nur den Konfigurationsparameter ssh_enable , um die SSH-Administratoranmeldung für die neue Appliance festzulegen. |
|
ovftool_arguments |
Optional. Verwenden Sie diesen 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 die temporären Netzwerkeinstellungen für die neue Appliance beschreiben. Siehe Konfigurationsparameter im Abschnitt new_vcsa , Unterabschnitt temporary_network . |
|
user_options |
Enthält nur den Konfigurationsparameter vcdb_migrateSet , um die Datentypen festzulegen, die Sie von der alten Appliance auf die neue Appliance übertragen möchten. Siehe Konfigurationsparameter im Abschnitt new_vcsa , Unterabschnitt user_options . |
|
source_vc - beschreibt die vorhandene Appliance, die Sie aktualisieren möchten. |
managing_esxi_or_vc |
Enthält die Konfigurationsparameter, die den ESXi-Quellhost oder die vCenter Server Appliance-Instanz beschreiben, auf dem sich die Appliance befindet, für die Sie ein Upgrade durchführen möchten. Weitere Informationen hierzu finden Sie unter Konfigurationsparameter im Abschnitt source_vc , Unterabschnitt managing_esxi_or_vc . |
vc_vcsa |
Enthält die Konfigurationsparameter, die die Quell-Appliance beschreiben, für die Sie ein Upgrade durchführen möchten. Weitere Informationen hierzu finden Sie unter Konfigurationsparameter im Abschnitt source_vc , Unterabschnitt vc_vcsa . |
|
source_vum - beschreibt die VMware Update Manager-Quellinstanz. Verwenden Sie sie, wenn der Migrationsassistent automatisch in der VMware Update Manager-Instanz ausgeführt werden soll. |
run_migration_assistant |
Optional, wenn die Quell-vCenter Server Appliance, für die Sie ein Upgrade ausführen möchten, mit einer VMware Update Manager-Instanz verbunden ist, die auf einer virtuellen Windows-Maschine ausgeführt wird. Verwenden Sie diesen Unterabschnitt, wenn der Migrationsassistent automatisch in der VMware Update Manager-Quellinstanz ausgeführt werden soll. Enthält die Konfigurationsparameter, mit denen die VMware Update Manager-Quellinstanz beschrieben wird, die zu der neu aktualisierten vCenter Server Appliance migriert wird. Weitere Informationen hierzu finden Sie unter Konfigurationsparameter im Abschnitt
Hinweis: Der
Migration Assistant verwendet standardmäßig Port 9123. Wird Port 9123 von einem anderen Dienst auf Ihrem
Update Manager-Computer verwendet, findet
Migration Assistant automatisch einen anderen freien Port. Sie können keinen benutzerdefinierten Port für den
Migration Assistant festlegen.
|
ceip : Beschreibt den Beitritt zum Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Programm, CEIP) von VMware. |
settings |
Enthält nur den Konfigurationsparameter Nur erforderlich bei einem Upgrade einer vCenter Server Appliance mit eingebettetem Platform Services Controller oder einer Platform Services Controller-Appliance.
Hinweis: Wenn der Konfigurationsparameter
ceip_enabled auf
true festgelegt ist, müssen Sie den CLI-Bereitstellungsbefehl mit dem Argument
--acknowledge-ceip ausführen.
Informationen über das CEIP finden Sie im Abschnitt „Konfigurieren des Programms zur Verbesserung der Benutzerfreundlichkeit“ in vCenter Server und Hostverwaltung. |
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. Beispielsweise wird durch "password":"my\"password"
das Kennwort „my"password“ festgelegt. Durch "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova"
wird der Pfad G:\vcsa\\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova festgelegt.
Die booleschen Werte dürfen nur Kleinbuchstaben enthalten. Entweder true
oder false
Beispiel: "ssh_enable":false
.
Konfigurationsparameter im Abschnitt new_vcsa
Name | Typ | Beschreibung |
---|---|---|
hostname |
string | Die IP-Adresse oder der FQDN des ESXi-Zielhosts, auf dem Sie die neue 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 neue Appliance verbunden werden soll. Das Netzwerk muss Teil der Netzwerkkonfiguration des ESXi-Zielhosts oder der vCenter Server Appliance-Instanz sein (wie durch den Konfigurationsparameter
Hinweis: Das Netzwerk muss über den
ESXi-Quellhost oder die
vCenter Server Appliance-Instanz (wie durch die Konfigurationsparameter
managing_esxi_or_vc identifiziert) zugänglich sein, auf dem bzw. der sich die Appliance befindet, die Sie aktualisieren möchten. Das Netzwerk muss außerdem von der Clientmaschine aus erreichbar sein, über die Sie das Upgrade durchführen.
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 neuen Appliance speichern. Der Zugriff auf den Datenspeicher muss über den ESXi-Zielhost erfolgen können.
Hinweis: Der Datenspeicher muss über mindestens 25 GB freien Speicherplatz verfügen.
|
port |
integer | Der HTTPS-Reverse-Proxy-Port des ESXi-Zielhosts. Der Standardport ist 443. Wird nur verwendet, wenn der ESXi-Zielhost einen benutzerdefinierten HTTPS-Reverse-Proxy-Port verwendet. |
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": "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 neue 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 neue Appliance verbunden werden soll. Das Netzwerk muss Teil der Netzwerkkonfiguration des ESXi-Zielhosts oder des DRS-Clusters sein.
Hinweis: Das Netzwerk muss vom
ESXi-Quellhost aus zugänglich sein, auf dem sich die zu aktualisierende Appliance befindet. Das Netzwerk muss außerdem von der Clientmaschine aus erreichbar sein, über die Sie das Upgrade durchführen.
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 neue 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 neuen 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 | Der HTTPS-Reverse-Proxy-Port der vCenter Server-Zielinstanz. Der Standardport ist 443. Wird nur verwendet, wenn die vCenter Server-Zielinstanz einen benutzerdefinierten HTTPS-Reverse-Proxy-Port verwendet. |
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 neue Appliance hinzugefügt werden soll. |
Name | Typ | Beschreibung |
---|---|---|
thin_disk_mode |
Boolean | Legen Sie diesen Parameter auf true fest, um die neue virtuelle Appliance mit schnellen virtuellen Festplatten bereitzustellen. |
deployment_option |
string | Die Größe der neuen Appliance.
Hinweis: Beachten Sie die Datenbankgröße der Appliance, die Sie aktualisieren möchten. Informationen zu einer externen Datenbank finden Sie unter
Festlegen der Oracle-Datenbankgröße und der Speichergröße für die neue 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 neue 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 |
---|---|---|
ip_family |
string | IP-Version für das temporäre Netzwerk der neuen Appliance. Legen Sie diesen Parameter auf |
mode |
string | IP-Zuweisung für das temporäre Netzwerk der neuen Appliance. Legen Sie diesen Parameter auf |
ip |
string | Temporäre IP-Adresse für die neue 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 temporären 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 für das temporäre Netzwerk der neuen Appliance.
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, falls der statische Netzwerkmodus für die Zuteilung temporärer IP-Adressen verwendet wird, wenn Sie den Parameter |
prefix |
string | Länge des Netzwerkpräfix für das temporäre Netzwerk der neuen Appliance. Wird nur verwendet, wenn der Parameter Die Präfixlänge des Netzwerks entspricht der Anzahl der in der Subnetzmaske festgelegten Bits. Wenn die Subnetzmaske beispielsweise 255.255.255.0 lautet, befinden sich 24 Bit in der Binärversion der Präfixlänge und die Präfixlänge des Netzwerks beträgt 24. Für IPv4 muss der Wert zwischen Für IPv6 muss der Wert zwischen |
gateway |
string | IP-Adresse des Standard-Gateways für das temporäre Netzwerk der neuen Appliance. 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 Dauer und die Größe des Speichers, der für die neue vCenter Server Appliance erforderlich ist, zu minimieren, verwenden Sie den
core -Wert.
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. |
Konfigurationsparameter im Abschnitt source_vc
Name | Typ | Beschreibung |
---|---|---|
hostname |
string | Die IP-Adresse oder der FQDN des ESXi-Quellhosts oder vCenter Server-Hosts, auf dem sich die Appliance befindet, für die Sie ein Upgrade durchführen möchten. |
username |
string | Ein Benutzername mit Administratorrechten auf dem ESXi-Quellhost, zum Beispiel „root“. |
password |
string | Das Kennwort des Benutzers mit Administratorrechten auf dem ESXi-Quellhost. |
port |
integer | Der HTTPS-Reverse-Proxy-Port des ESXi-Quellhosts. Der Standardport ist 443. Wird nur verwendet, wenn der ESXi-Quellhost einen benutzerdefinierten HTTPS-Reverse-Proxy-Port verwendet. |
Name | Typ | Beschreibung |
---|---|---|
hostname |
string | Die IP-Adresse oder der FQDN der Quell-Appliance, für die Sie ein Upgrade durchführen möchten. |
username |
string | vCenter Single Sign-On-Administrator der Quell-Appliance, z. B. „[email protected]“.
Wichtig: Der Benutzername muss das Format administrator@
Ihr_Domänenname aufweisen.
|
password |
string | Das Kennwort des vCenter Single Sign-On-Administrators der Quell-Appliance. |
root_password |
string | Das Kennwort des Root-Benutzers des Betriebssystems der Quell-Appliance. |
export_dir |
string | Verzeichnis für den Export von Quelldaten und -konfiguration. |
Konfigurationsparameter im Abschnitt source.vum
Name | Typ | Beschreibung |
---|---|---|
esxi_hostname |
string | Die IP-Adresse oder der FQDN des ESXi-Hosts, auf dem sich die VMware Update Manager-Quellinstanz befindet. Wenn ein FQDN angegeben wird, muss dieser auf dem Clientcomputer, von dem aus Sie das Upgrade durchführen, auflösbar sein. |
esxi_username |
string | Ein Benutzername mit Administratorrechten auf dem ESXi-Host, zum Beispiel „root“. |
esxi_password |
string | Das Kennwort des Benutzers mit Administratorrechten auf dem ESXi-Host. |
esxi_port |
string | Der HTTPS-Reverse-Proxy-Port des ESXi-Hosts. Der Standardport ist 443. Wird nur verwendet, wenn der ESXi-Host einen benutzerdefinierten HTTPS-Reverse-Proxy-Port verwendet. |
vum_hostname |
string | Die IP-Adresse oder der FQDN der virtuellen Windows-Maschine, auf der die VMware Update Manager-Quellinstanz ausgeführt wird. Wenn ein FQDN angegeben wird, muss dieser auf dem Clientcomputer, von dem aus Sie das Upgrade durchführen, auflösbar sein. |
vum_os_username |
string | Der Benutzername des Administrators der virtuellen Windows-Maschine, auf der die VMware Update Manager-Quellinstanz ausgeführt wird. |
vum_os_password |
string | Das Kennwort des Administrators der virtuellen Windows-Maschine, auf der die VMware Update Manager-Quellinstanz ausgeführt wird. Sofern nicht bereits angegeben, werden Sie während der Vorlagenüberprüfung zur Eingabe des Kennworts bei der Befehlskonsole aufgefordert. |
export_dir |
string | Verzeichnis für den Export von Quelldaten und -konfiguration. |
Konfigurationsparameter im Abschnitt ceip
Name | Typ | Beschreibung |
---|---|---|
ceip_enabled |
Boolean | Legen Sie den Parameter auf true fest, um dem CEIP für die neu aktualisierte Appliance beizutreten. |