Bevor Sie das CLI-Installationsprogramm ausführen, um eine vCenter Server Appliance bereitzustellen, müssen Sie eine JSON-Datei mit Konfigurationsparametern und deren Werten für die Bereitstellungsspezifikation vorbereiten.
Das vCenter Server-Installationsprogramm enthält JSON-Vorlagen für alle Bereitstellungsoptionen. Informationen zu den Vorlagen finden Sie unter JSON-Vorlagen für die CLI-Bereitstellung der vCenter Server Appliance.
Sie können eine Appliance mit minimalen Konfigurationseinstellungen bereitstellen, indem Sie die Werte für die Konfigurationsparameter in der JSON-Vorlage für Ihre Spezifikation festlegen. Diese voreingestellten Werte können Sie bearbeiten, die Konfigurationsparameter entfernen und Konfigurationsparameter für benutzerdefinierte Konfigurationen hinzufügen.
Navigieren Sie zum Unterverzeichnis des Installationsprogramms für Ihr Betriebssystem und führen Sie den Befehl vcsa-deploy install --template-help aus, um eine vollständige Liste der Konfigurationsparameter und ihrer Beschreibungen zu erhalten, oder informieren Sie sich unter Bereitstellungs-Konfigurationsparameter.
Voraussetzungen
- Sie müssen mit der JSON-Syntax vertraut sein.
- Herunterladen und Mounten des vCenter Server-Installationsprogramms.
Prozedur
Nächste Maßnahme
Sie können zusätzliche Vorlagen für Ihre Bereitstellungsspezifikation erstellen und speichern.
JSON-Vorlagen für die CLI-Bereitstellung der vCenter Server Appliance
Das vCenter Server-Installationsprogramm enthält JSON-Vorlagen mit den Mindestkonfigurationsparametern für alle Bereitstellungsoptionen. Die Vorlagen befinden sich im Verzeichnis vcsa-cli-installer/templates/install.
Für jede Bereitstellungsoption gibt es eine Vorlage zur Bereitstellung der Appliance auf einem ESXi-Host und eine weitere Vorlage zur Bereitstellung der Appliance auf einer vCenter Server-Instanz.
Vorlage | Beschreibung |
---|---|
embedded_vCSA_on_ESXi.json | Enthält die Mindestkonfigurationsparameter, die für die Bereitstellung einer vCenter Server Appliance auf einem ESXi-Host erforderlich sind. |
vCSA_with_cluster_on_ESXi.json | Enthält die Mindestkonfigurationsparameter, die für die Bereitstellung einer vCenter Server Appliance mit einem aus einem Knoten bestehenden vSAN-Cluster und einem vLCM-verwalteten Cluster auf einem ESXi-Host erforderlich sind. |
embedded_vCSA_on_VC.json | Enthält die Mindestkonfigurationsparameter, die für die Bereitstellung einer vCenter Server Appliance auf einer vCenter Server-Instanz erforderlich sind. |
embedded_vCSA_replication_on_ESXi.json | Enthält die Mindestkonfigurationsparameter, die für die Bereitstellung einer vCenter Server Appliance als Replizierungspartner für einen anderen eingebetteten vCenter Server auf einem ESXi-Host erforderlich sind. |
embedded_vCSA_replication_on_VC.json | Enthält die Mindestkonfigurationsparameter, die für die Bereitstellung eines Replizierungspartners einer vCenter Server Appliance für eine andere vCenter Server Appliance auf einer vCenter Server-Instanz erforderlich sind. |
Bereitstellungs-Konfigurationsparameter
Wenn Sie die JSON-Konfigurationsdateien für die CLI-Bereitstellung vorbereiten, müssen Sie Parameter und Werte festlegen, um Eingabedaten für die Bereitstellung einer vCenter Server Appliance bereitzustellen.
Abschnitte und Unterabschnitte der Konfigurationsparameter in den JSON-Bereitstellungsdateien
Die Konfigurationsparameter in den JSON-Konfigurationsdateien für ein CLI-Upgrade sind in Abschnitte und Unterabschnitte unterteilt.
Abschnitt | Unterabschnitt | Beschreibung |
---|---|---|
new_vcsa : Beschreibt die Appliance, die Sie bereitstellen 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.
Je nachdem, ob Sie einen vSAN oder einen von vLCM verwalteten Cluster während der Bereitstellung konfigurieren möchten, finden Sie im entsprechenden Abschnitt detaillierte Informationen zu den Konfigurationsparametern.
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. Weitere Informationen hierzu finden Sie unter Konfigurationsparameter im Abschnitt
Hinweis: Sie müssen entweder den Unterabschnitt
vc oder den Unterabschnitt
esxi ausfüllen.
|
|
appliance |
Enthält die Konfigurationsparameter, die die Appliance beschreiben. Weitere Informationen hierzu finden Sie unter Konfigurationsparameter im Abschnitt new_vcsa , Unterabschnitt appliance . |
|
network |
Enthält die Konfigurationsparameter, die die Netzwerkeinstellungen für die Appliance beschreiben. Weitere Informationen hierzu finden Sie unter Konfigurationsparameter im Abschnitt new_vcsa , Unterabschnitt network . |
|
os |
Enthält die Konfigurationsparameter, die die Betriebssystem-Einstellungen für die Appliance beschreiben. Weitere Informationen hierzu finden Sie unter Konfigurationsparameter im Abschnitt new_vcsa , Unterabschnitt os . |
|
sso |
Enthält die Konfigurationsparameter, die die vCenter Single Sign-On-Einstellungen für die Appliance beschreiben. Weitere Informationen hierzu finden Sie unter Konfigurationsparameter im Abschnitt new_vcsa , Unterabschnitt sso . |
|
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 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.
|
|
ceip : Beschreibt den Beitritt zum Programm zur Verbesserung der Benutzerfreundlichkeit (Customer Experience Improvement Programm, CEIP) von VMware. |
settings |
Enthält nur den Konfigurationsparameter
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. |
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. "password":"my\"password"
legt beispielsweise das Kennwort my"password fest. Ebenso legt "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova"
den Pfad G:\vcsa\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova fest.
Die booleschen Werte dürfen nur Kleinbuchstaben enthalten. Sie müssen entweder true
oder false
sein. 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 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. |
datacenter |
string | Ein bestimmtes Datencenter, das Sie erstellen möchten. |
cluster |
string | Name des vSAN oder des vLCM-verwalteten Clusters. |
compression_only |
Boolean | Legen Sie den Wert auf true fest, um die Komprimierung im vSAN-Cluster zu aktivieren. Wenn dieser Parameter auf true festgelegt ist, muss der Parameter deduplication_and_compression auf false festgelegt werden. |
deduplication_and_compression |
Boolean | Legen Sie den Wert auf true fest, um die Komprimierung und Deduplizierung im vSAN-Cluster zu aktivieren. Wenn dieser Parameter auf true festgelegt ist, muss der Parameter compression_only auf false festgelegt werden. |
cache_disk |
Eine Liste der UUIDs oder kanonischen Namen von Festplatten, die Sie für den Cache verwenden möchten. Geben Sie nur SSDs an. | |
capacity_disk |
Eine Liste der UUIDs oder kanonischen Namen von Festplatten, die Sie für den Speicher verwenden möchten. Geben Sie entweder SSDs oder HDDs an. | |
enable_vlcm |
Boolean | Legen Sie diese true fest, um einen vLCM-verwalteten Cluster zu erstellen. |
enable_vsan_esa |
Boolean | Legen Sie diese Eigenschaft auf true fest, um einen vSAN-Cluster mit aktivierter vSAN ESA zu erstellen. vSAN Express Storage Architecture bietet eine Architektur der nächsten Generation, die auf die optimale Nutzung hochleistungsfähiger Speichergeräte und somit auf gesteigerte Leistung und Effizienz ausgelegt ist. |
single_tier |
Array | Eine Liste von UUIDs oder kanonischen Namen von Festplatten, die Sie zu einem vSAN-Speicherpool hinzufügen möchten. Nur erforderlich, wenn Sie enable_vsan_esa auf true festlegen. |
vsan_hcl_database_path |
String | Pfad der lokalen vSAN-HCL-Datenbank. Wenn die an diesem Speicherort vorhandene vSAN-HCL-Datenbank veraltet ist, lädt das Installationsprogramm die ältere Version herunter und ersetzt sie durch die neueste Version. Nur erforderlich, wenn Sie enable_vsan_esa auf true festlegen. |
datastore |
string | Der Name des Datenspeichers, in dem Sie die Konfigurationsdateien und virtuellen Festplatten der Appliance speichern möchten
Hinweis:
Der Zugriff auf den Datenspeicher muss über den ESXi-Host erfolgen können. Wenn Sie den Thin-Festplattenmodus verwenden, sollte die Größe des Datenspeichers mindestens 25 GB aufweisen. |
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 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 die Konfigurationsdateien und virtuellen Festplatten der Appliance speichern möchten
Hinweis:
Der Zugriff auf den Datenspeicher muss über den ESXi-Host erfolgen können. Wenn Sie den Thin-Festplattenmodus verwenden, sollte die Größe des Datenspeichers mindestens 25 GB aufweisen. |
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 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 |
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, legen Sie den Wert als kommagetrennte Liste von Zeichenfolgen fest. Beispiel:
["parent_folder", "child_folder", "datacenter_name"]
Hinweis: Der Wert unterliegt der Groß-/Kleinschreibung.
|
datastore |
string | Der Name des Datenspeichers, in dem Sie die Konfigurationsdateien und 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 | 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 |
array | Der ESXi-Zielhost oder der DRS-Cluster, auf bzw. in dem Sie die 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, legen Sie den Wert als kommagetrennte Liste von Zeichenfolgen fest. Beispiel:
["parent_folder", "child_folder", "esxi-host.domain.com"]
Wenn der
ESXi-Zielhost Teil eines Clusters ist, geben Sie den Pfad als kommatrennte Liste von Zeichenfolgen an. Beispiel:
["cluster_name", "esxi-host.domain.com"]
Hinweis: Der Wert unterliegt der Groß-/Kleinschreibung.
|
vm_folder |
string | Optional. Der Name des VM-Ordners, in dem die Appliance bereitgestellt wird. |
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 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. |
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" Optional, wenn der Parameter |
prefix |
string | Präfixlänge des Netzwerks. 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 IPv6 kann der Wert |
ports |
string | Optional. Portnummern, die die vCenter Server Appliance für direkte HTTP-Verbindungen verwendet. Standardmäßig leitet Port 80 Anforderungen an HTTPS-Port 443 weiter. Sie können den HTTP- und den HTTPS-Port für vCenter Server anpassen. Wenn Sie benutzerdefinierte HTTP- und HTTPS-Portnummern angeben, stellen Sie sicher, dass Sie keinen bereits von vCenter Server verwendeten Port oder die standardmäßigen HTTP- und HTTPS-Ports 80 und 443 verwenden. Die Optionen zum Festlegen eines benutzerdefinierten Ports lauten: Im folgenden Beispiel werden die Ports 81 und 444 für den HTTP-Port und den HTTPS-Port festgelegt: ports: {"rhttpproxy.ext.port1":"81", "rhttpproxy.ext.port2":"444"} Weitere Informationen zu von vCenter Server verwendeten Ports finden Sie unter Erforderliche Ports für vCenter Server. |
system_name |
string | Primäre Netzwerkidentität. Kann eine IP-Adresse oder ein FQDN sein (bevorzugt FQDN). Nach der Bereitstellung kann der Wert dieses Parameters nicht mehr geändert werden. Der FQDN und die Zahlen in Dezimalpunktschreibweise müssen den RFC 1123-Richtlinien entsprechen. |
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. |
ntp_servers |
string oder array | Optional. Hostnamen oder IP-Adressen von einem oder mehreren NTP-Servern für die Uhrzeitsynchronisierung.
Um mehrere NTP-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" |
ssh_enable |
Boolean | Dieser Parameter wird auf true gesetzt, um die SSH-Administratoranmeldung für die Appliance zu aktivieren.
Hinweis: Für die Hochverfügbarkeit der
vCenter Server Appliance ist SSH-Remotezugriff auf die Appliance erforderlich.
|
time_tools_sync |
Boolean | Optional. Dieser Parameter wird auf Wird ignoriert, wenn Sie NTP-Server für die Uhrzeitsynchronisierung einrichten, d. h. den Parameter |
Name | Typ | Beschreibung |
---|---|---|
password |
string | Kennwort des vCenter Single Sign-On-Administrator-Benutzers, administrator@ihr_domänenname. Wenn Sie eine vCenter Server Appliance als erste Instanz in einer neuen vCenter Single Sign-On-Domäne bereitstellen, müssen Sie das Kennwort für den vCenter Single Sign-On-Administratorbenutzer festlegen. 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 ASCII-Zeichen darstellen. |
domain_name |
string | vCenter Single Sign-On-Domänenname, z. B. vsphere.local. Wenn Sie eine vCenter Server Appliance als erste Instanz in einer neuen vCenter Single Sign-On-Domäne bereitstellen, müssen Sie den Namen für die neue vCenter Single Sign-On-Domäne festlegen. |
replication_partner_hostname |
string | Der Systemname des Partner-vCenter Server. Nur erforderlich, wenn Sie einen Replizierungspartner in einer vorhandenen vCenter Single Sign-On-Domäne bereitstellen. |
sso_port |
integer | Der HTTPS-Reverse-Proxy-Port des Partner-vCenter Server. Der Standardport ist 443. Sollte nur verwendet werden, wenn der Partner einen benutzerdefinierten HTTPS-Reverse-Proxy-Port verwendet. |
Konfigurationsparameter im Abschnitt ceip
Name | Typ | Beschreibung |
---|---|---|
ceip_enabled |
Boolean | Setzen Sie den Parameter auf true , um dem CEIP für diese Appliance beizutreten. |