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. Siehe Konfigurationsparameter im Abschnitt new.vcsa , Unterabschnitt os . |
|
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.
|
|
sso |
Enthält nur den Konfigurationsparameter Nur erforderlich, wenn Sie ein Upgrade einer vCenter Server Appliance 5.5 mit einem eingebetteten Platform Services Controller durchführen. |
|
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. |
esxi |
Enthält die Konfigurationsparameter, die den ESXi-Quellhost 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 esxi . |
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, wenn Sie ein Upgrade einer vCenter Server Appliance-Instanz mit eingebetteter Platform Services Controller-Instanz, einer vCenter Server Appliance 5.5-Instanz mit eingebetteter vCenter Single Sign-On-Instanz oder einer Platform Services Controller-Appliance durchführen.
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.5.0.XXXX-YYYYYYY_OVF10.ova"
wird der Pfad G:\vcsa\\VMware-vCenter-Server-Appliance-6.5.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 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 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. |
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 „administrator@vsphere.local“. |
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:
oder
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 ESXi-Zielhost oder der DRS-Cluster, auf bzw. in dem Sie die neue Appliance bereitstellen möchten.
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.
Wenn sich der
ESXi-Zielhost oder der DRS-Cluster 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:
oder
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:
oder
Hinweis: Der Wert unterliegt der Groß-/Kleinschreibung.
|
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 |
---|---|---|
ssh.enable |
Boolean | Dieser Parameter wird auf true festgelegt, um die SSH-Administratoranmeldung für die neue Appliance zu aktivieren. |
Name | Typ | Beschreibung |
---|---|---|
site-name |
string | vCenter Single Sign-On-Site-Name für die neue Appliance. Nur erforderlich, wenn Sie ein Upgrade einer vCenter Server Appliance 5.5 mit einer eingebetteten vCenter Single Sign-On-Instanz durchführen. |
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:
oder
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 |
system.name |
string | Primäre Netzwerkidentität für das temporäre Netzwerk der neuen Appliance. Kann eine IP-Adresse oder ein FQDN sein (bevorzugt FQDN). Der FQDN und die Zahlen in Dezimalpunktschreibweise müssen den RFC 1123-Richtlinien entsprechen. |
Name | Typ | Beschreibung |
---|---|---|
vcdb.migrateSet |
string | Die Datentypen, die von der alten Appliance auf die neue Appliance übertragen werden sollen.
Hinweis: Um die Dauer des Upgradevorgangs und die Speicheranforderungen an die neue Appliance zu minimieren, verwenden Sie den
core -Wert.
|
Konfigurationsparameter im Abschnitt source.vc
Name | Typ | Beschreibung |
---|---|---|
hostname |
string | Die IP-Adresse oder der FQDN des ESXi-Quellhosts, 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. „administrator@vsphere.local“.
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. |
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. |