Prima di eseguire il programma di installazione della CLI per distribuire un'appliance di vCenter Server, è necessario preparare un file JSON con i parametri di configurazione e i relativi valori per la specifica di distribuzione.
Il programma di installazione di vCenter Server contiene modelli JSON per tutte le opzioni di distribuzione. Per informazioni sui modelli, vedere Modelli JSON per la distribuzione della CLI dell'appliance di vCenter Server.
È possibile distribuire un'appliance con configurazioni minime impostando valori sui parametri di configurazione nel modello JSON per la specifica. È possibile modificare i valori preimpostati, rimuovere i parametri di configurazione e aggiungere parametri di configurazione per le configurazioni personalizzate.
Per un elenco completo dei parametri di configurazione e delle relative descrizioni, passare alla sottodirectory del programma di installazione del sistema operativo ed eseguire il comando vcsa-deploy install --template-help oppure vedere Parametri di configurazione della distribuzione.
Prerequisiti
- È necessario conoscere la sintassi JSON.
- Download e montaggio del programma di installazione di vCenter Server.
Procedura
Operazioni successive
È possibile creare e salvare modelli aggiuntivi, se necessario, per la specifica di distribuzione.
Modelli JSON per la distribuzione della CLI dell'appliance di vCenter Server
Il programma di installazione di vCenter Server include modelli JSON con i parametri di configurazione minimi per tutte le opzioni di distribuzione. I modelli si trovano nella directory vcsa-cli-installer/templates/install.
Per ogni opzione di distribuzione è presente un modello per la distribuzione dell'appliance in un host ESXi e un altro modello per la distribuzione dell'appliance in un'istanza di vCenter Server.
Modello | Descrizione |
---|---|
embedded_vCSA_on_ESXi.json | Contiene i parametri di configurazione minimi necessari per la distribuzione di un'appliance di vCenter Server in un host ESXi. |
vCSA_with_cluster_on_ESXi.json | Contiene i parametri di configurazione minimi necessari per la distribuzione di un'appliance di vCenter Server con un vSAN a singolo nodo e un cluster gestito da vLCM in un host ESXi. |
embedded_vCSA_on_VC.json | Contiene i parametri di configurazione minimi necessari per la distribuzione di un'appliance di vCenter Server in un'istanza di vCenter Server. |
embedded_vCSA_replication_on_ESXi.json | Contiene i parametri di configurazione minimi necessari per la distribuzione di un'appliance di vCenter Server come partner di replica in un'altra vCenter Server incorporata in un host ESXi. |
embedded_vCSA_replication_on_VC.json | Contiene i parametri di configurazione minimi necessari per la distribuzione di un partner di replica dell'appliance di vCenter Server in un'altra appliance di vCenter Server in un'istanza di vCenter Server. |
Parametri di configurazione della distribuzione
Quando si preparano i file di configurazione JSON per una distribuzione della CLI, è necessario impostare parametri e valori per fornire i dati di input per la distribuzione di un'appliance vCenter Server.
Sezioni e sottosezioni dei parametri di configurazione nei file di distribuzione JSON
I parametri di configurazione nei file di configurazione JSON per un aggiornamento della CLI sono organizzati in sezioni e sottosezioni.
Sezione | Sottosezione | Descrizione |
---|---|---|
new_vcsa : descrive l'appliance che si desidera distribuire |
esxi |
Utilizzare solo se si desidera distribuire l'appliance direttamente in un host ESXi. Contiene i parametri di configurazione che descrivono l'host ESXi di destinazione.
A seconda che si desideri configurare un cluster gestito da vSAN o vLCM durante la distribuzione, vedere la sezione pertinente per informazioni dettagliate sui parametri di configurazione.
Nota: È necessario compilare la sottosezione
esxi o
vc .
|
vc |
Utilizzarla solo se si desidera distribuire l'appliance nell'inventario di un'istanza di vCenter Server. Contiene i parametri di configurazione che descrivono l'host ESXi di destinazione o il cluster DRS dall'inventario di vCenter Server. Vedere Parametri di configurazione nella sezione
Nota: È necessario compilare la sottosezione
vc o
esxi .
|
|
appliance |
Contiene i parametri di configurazione che descrivono l'appliance. Vedere Parametri di configurazione nella sezione new_vcsa , sottosezione appliance . |
|
network |
Contiene i parametri di configurazione che descrivono le impostazioni di rete per l'appliance. Vedere Parametri di configurazione nella sezione new_vcsa , sottosezione network . |
|
os |
Contiene i parametri di configurazione che descrivono le impostazioni del sistema operativo per l'appliance. Vedere Parametri di configurazione nella sezione new_vcsa , sottosezione os . |
|
sso |
Contiene i parametri di configurazione che descrivono le impostazioni di vCenter Single Sign-On per l'appliance. Vedere Parametri di configurazione nella sezione new_vcsa , sottosezione sso . |
|
ovftool_arguments |
Sottosezione facoltativa per l'aggiunta di argomenti arbitrari e relativi valori al comando dello strumento OVF generato dal programma di installazione.
Importante: Il programma di installazione di
vCenter Server non convalida i parametri di configurazione nella sottosezione
ovftool_arguments . Se si impostano argomenti che lo strumento OVF non riconosce, la distribuzione potrebbe non riuscire.
|
|
ceip : descrive la partecipazione al Programma di Miglioramento dell'Esperienza del Cliente di VMware. |
settings |
Contiene solo il parametro di configurazione
Nota: Se è impostata su
true , è necessario eseguire il comando di distribuzione della CLI con l'argomento
--acknowledge-ceip.
Per informazioni sul Programma di Miglioramento dell'Esperienza del Cliente di VMware, vedere la sezione relativa alla configurazione di tale programma in vCenter Server e gestione degli host. |
I valori stringa, incluse le password, possono contenere solo caratteri ASCII. I caratteri ASCII estesi e i caratteri non ASCII non sono supportati.
Per impostare un valore che contenga una barra rovesciata (\) o virgolette ("), è necessario precedere il carattere con la barra rovesciata (\). Ad esempio, "password":"my\"password"
imposta la password my"password. Allo stesso modo, "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova"
imposta il percorso G:\vcsa\VMware-vCenter-Server-Appliance-8.0.0.XXXX-YYYYYYY_OVF10.ova.
I valori booleani possono contenere solo caratteri minuscoli. Deve essere true
o false
. Ad esempio "ssh_enable":false
.
Parametri di configurazione nella sezione new_vcsa
Nome | Tipo | Descrizione |
---|---|---|
hostname |
stringa | Indirizzo IP o nome di dominio completo dell'host ESXi di destinazione in cui si desidera distribuire l'appliance. |
username |
stringa | Nome utente con privilegi amministrativi nell'host ESXi di destinazione, ad esempio root. |
password |
stringa | Password dell'utente con privilegi amministrativi nell'host ESXi di destinazione. |
deployment_network |
stringa | Nome della rete a cui connettere l'appliance.
Nota: La rete deve essere accessibile dall'host
ESXi di destinazione.
Questo parametro viene ignorato se l'host ESXi di destinazione ha una sola rete. |
datacenter |
stringa | Data center specifico che si desidera creare. |
cluster |
stringa | Nome del cluster gestito da vSAN o vLCM. |
compression_only |
Booleano | Impostare il valore su true per abilitare la compressione nel cluster vSAN. Se questo parametro è impostato su true , il parametro deduplication_and_compression deve essere impostato su false . |
deduplication_and_compression |
Booleano | Impostare il valore su true per abilitare la compressione e la deduplicazione nel cluster vSAN. Se questo parametro è impostato su true , il parametro compression_only deve essere impostato su false . |
cache_disk |
Elenco di UUID o nomi canonici dei dischi che si desidera utilizzare per la cache. Specificare solo SSD. | |
capacity_disk |
Elenco di UUID o nomi canonici dei dischi che si desidera utilizzare per lo storage. Specificare SSD o HDD. | |
enable_vlcm |
Booleano | Impostare su true per creare un cluster gestito da vLCM. |
enable_vsan_esa |
Booleano | Impostare su true per creare un cluster vSAN con vSAN ESA abilitato. vSAN Express Storage Architecture è un'architettura di nuova generazione progettata per ottimizzare i dispositivi di storage ad alte prestazioni per aumentarne l'efficienza. |
single_tier |
Array | Elenco di UUID o nomi canonici dei dischi che si desidera aggiungere a un pool di storage di vSAN. Obbligatorio solo se si imposta enable_vsan_esa su true . |
vsan_hcl_database_path |
Stringa | Percorso del database HCL vSAN locale. Se il database HCL vSAN presente in questa posizione è obsoleto, il programma di installazione scaricherà e sostituirà la versione precedente con la versione più recente. Obbligatorio solo se si imposta enable_vsan_esa su true . |
datastore |
stringa | Nome del datastore in cui si desidera archiviare i file di configurazione e i dischi virtuali dell'appliance.
Nota:
Il datastore deve essere accessibile dall'host ESXi. Se si utilizza la modalità disco thin, le dimensione del datastore devono essere almeno 25 GB. |
port |
numero intero | Porta del proxy inverso HTTPS dell'host ESXi di destinazione. La porta predefinita è 443. Utilizzare solo se l'host ESXi di destinazione usa una porta del proxy inverso HTTPS personalizzata. |
Nome | Tipo | Descrizione |
---|---|---|
hostname |
stringa | Indirizzo IP o nome di dominio completo dell'host ESXi di destinazione in cui si desidera distribuire l'appliance. |
username |
stringa | Nome utente con privilegi amministrativi nell'host ESXi di destinazione, ad esempio root. |
password |
stringa | Password dell'utente con privilegi amministrativi nell'host ESXi di destinazione. |
deployment_network |
stringa | Nome della rete a cui connettere l'appliance.
Nota: La rete deve essere accessibile dall'host
ESXi di destinazione.
Questo parametro viene ignorato se l'host ESXi di destinazione ha una sola rete. |
datastore |
stringa | Nome del datastore in cui si desidera archiviare i file di configurazione e i dischi virtuali dell'appliance.
Nota:
Il datastore deve essere accessibile dall'host ESXi. Se si utilizza la modalità disco thin, le dimensione del datastore devono essere almeno 25 GB. |
port |
numero intero | Porta del proxy inverso HTTPS dell'host ESXi di destinazione. La porta predefinita è 443. Utilizzare solo se l'host ESXi di destinazione usa una porta del proxy inverso HTTPS personalizzata. |
Nome | Tipo | Descrizione |
---|---|---|
hostname |
stringa | Indirizzo IP o nome di dominio completo dell'istanza di vCenter Server di destinazione in cui si desidera distribuire l'appliance. |
username |
stringa | Nome utente dell'amministratore di vCenter Single Sign-On nell'istanza di vCenter Server di destinazione, ad esempio [email protected]. |
password |
stringa | Password dell'utente amministratore di vCenter Single Sign-On nell'istanza di vCenter Server di destinazione. |
deployment_network |
stringa | Nome della rete a cui connettere l'appliance.
Nota: La rete deve essere accessibile dall'host
ESXi di destinazione o dal cluster DRS in cui si desidera distribuire l'appliance.
Questa opzione viene ignorata se l'host ESXi di destinazione o il cluster DRS ha una sola rete. |
datacenter |
array | Data center di vCenter Server che contiene l'host ESXi di destinazione o il cluster DRS in cui si desidera distribuire l'appliance.
Se il data center si trova in una cartella o in una struttura di cartelle, specificare il valore come elenco di stringhe separate da virgole. Ad esempio,
["parent_folder", "child_folder", "datacenter_name"]
Nota: Per questo valore viene fatta distinzione tra maiuscole e minuscole.
|
datastore |
stringa | Nome del datastore in cui si desidera archiviare i file di configurazione e i dischi virtuali dell'appliance.
Nota:
Il datastore deve essere accessibile dall'host ESXi di destinazione o dal cluster DRS. Il datastore deve avere almeno 25 GB di spazio libero. |
port |
numero intero | Porta del proxy inverso HTTPS dell'istanza di vCenter Server di destinazione. La porta predefinita è 443. Utilizzare solo se l'istanza di vCenter Server di destinazione utilizza una porta del proxy inverso HTTPS personalizzata. |
target |
array | Host ESXi di destinazione o cluster DRS in cui si desidera distribuire l'appliance.
Importante: È necessario fornire il nome visualizzato nell'inventario di
vCenter Server. Ad esempio, se il nome dell'host
ESXi di destinazione è un indirizzo IP nell'inventario di
vCenter Server, non è possibile fornire un nome di dominio completo.
Se l'host
ESXi di destinazione o il cluster DRS si trova in una cartella o in una struttura di cartelle, specificare il valore come elenco di stringhe separate da virgole. Ad esempio,
["parent_folder", "child_folder", "esxi-host.domain.com"]
Se l'host
ESXi di destinazione fa parte di un cluster, specificare il percorso come elenco di stringhe separate da virgole. Ad esempio,
["cluster_name", "esxi-host.domain.com"]
Nota: Per questo valore viene fatta distinzione tra maiuscole e minuscole.
|
vm_folder |
stringa | Facoltativo. Nome della cartella della macchina virtuale in cui viene distribuita l'appliance. |
Nome | Tipo | Descrizione |
---|---|---|
thin_disk_mode |
Booleano | Impostare su true per distribuire l'appliance con dischi virtuali thin. |
deployment_option |
stringa | Dimensioni dell'appliance.
|
image |
stringa | Facoltativo. Percorso del file locale o URL del pacchetto di installazione dell'appliance vCenter Server. Per impostazione predefinita, il programma di installazione utilizza il pacchetto di installazione incluso nel file ISO nella cartella vcsa. |
name |
stringa | Nome della macchina virtuale per l'appliance. Può contenere solo caratteri ASCII tranne un segno di percentuale (%), una barra rovesciata (\) o una barra (/) e non deve includere più di 80 caratteri. |
ovftool_path |
stringa | Facoltativo. Percorso del file locale eseguibile dello strumento OVF. Per impostazione predefinita, il programma di installazione utilizza l'istanza dello strumento OVF inclusa nel file ISO nella cartella vcsa/ovftool. |
Nome | Tipo | Descrizione |
---|---|---|
ip_family |
stringa | Versione IP della rete dell'appliance. Impostare su |
mode |
stringa | Assegnazione dell'indirizzo IP per la rete dell'appliance. Impostare su |
ip |
stringa | Indirizzo IP dell'appliance. Obbligatorio solo se si utilizza l'assegnazione statica, ovvero se si imposta il parametro È necessario impostare un indirizzo IPv4 o IPv6 che corrisponda alla versione dell'IP di rete, ovvero al valore del parametro Un indirizzo IPv4 deve essere conforme alle linee guida RFC 790. Un indirizzo IPv6 deve essere conforme alle linee guida RFC 2373. |
dns_servers |
stringa o array | Indirizzi IP di uno o più server DNS.
Per impostare più server DNS, utilizzare un elenco di stringhe separate da virgole o un elenco separato da virgole come singola stringa per fornire il percorso. Ad esempio,
["x.y.z.a", "x.y.z.b"]o "x.y.z.a, x.y.z.b" Facoltativo quando il parametro |
prefix |
stringa | Lunghezza del prefisso di rete. Utilizzare solo se il parametro La lunghezza del prefisso di rete è il numero di bit impostati nella subnet mask. Ad esempio, se la subnet mask è 255.255.255.0, nella versione binaria della lunghezza del prefisso sono presenti 24 bit, quindi la lunghezza del prefisso di rete è 24. Per la versione IPv4, il valore deve essere compreso tra Per la versione IPv6, il valore deve essere compreso tra |
gateway |
stringa | Indirizzo IP del gateway predefinito. Per la versione IPv6, il valore può essere |
ports |
stringa | Facoltativo. Numeri di porta utilizzati dall'appliance vCenter Server per le connessioni HTTP dirette. Per impostazione predefinita, la porta 80 reindirizza le richieste alla porta HTTPS 443. È possibile personalizzare le porte HTTP e HTTPS di vCenter Server. Se si specifica un numero di porta HTTP o HTTPS personalizzato, assicurarsi di non utilizzare una porta già utilizzata da vCenter Server o le porte HTTP e HTTPS predefinite 80 e 443. Le opzioni per specificare una porta personalizzata sono: Nell'esempio seguente vengono specificate le porte 81 e 444 come porte HTTP e HTTPS: ports: {"rhttpproxy.ext.port1":"81", "rhttpproxy.ext.port2":"444"} Per ulteriori informazioni sulle porte utilizzate da vCenter Server, vedere Porte necessarie per i vCenter Server. |
system_name |
stringa | Identità di rete primaria. Può essere un indirizzo IP o un nome di dominio completo. È preferibile il nome di dominio completo. Non è possibile modificare il valore di questo parametro dopo la distribuzione. Il nome di dominio completo e i numeri decimali tratteggiati devono essere conformi alle linee guida RFC 1123. |
Nome | Tipo | Descrizione |
---|---|---|
password |
stringa | Password dell'utente root del sistema operativo dell'appliance. La password può contenere da 8 a 20 caratteri e deve includere almeno una lettera maiuscola, almeno una lettera minuscola, almeno un numero e almeno un carattere speciale, ad esempio un segno di dollaro ($), un cancelletto (#), una chiocciola (@), un punto (.) o un punto esclamativo (!). Tutti i caratteri devono essere caratteri ASCII inferiori senza spazi. |
ntp_servers |
stringa o array | Facoltativo. Nomi host o indirizzi IP di uno o più server NTP per la sincronizzazione dell'ora.
Per impostare più di un server NTP, utilizzare un elenco di stringhe separate da virgole o un elenco separato da virgole come singola stringa per fornire il percorso. Ad esempio,
["x.y.z.a", "x.y.z.b"]o "x.y.z.a, x.y.z.b" |
ssh_enable |
Booleano | Impostare su true per abilitare l'accesso dell'amministratore SSH all'appliance.
Nota: L'alta disponibilità dell'appliance
vCenter Server richiede l'accesso SSH remoto all'appliance.
|
time_tools_sync |
Booleano | Facoltativo. Impostare su Questo parametro viene ignorato se si impostano i server NTP per la sincronizzazione dell'ora, ovvero se si imposta il parametro |
Nome | Tipo | Descrizione |
---|---|---|
password |
stringa | Password dell'utente amministratore di vCenter Single Sign-On administrator@your_domain_name. Se si distribuisce un'appliance vCenter Server come prima istanza in un nuovo dominio di vCenter Single Sign-On, è necessario impostare la password per l'utente amministratore di vCenter Single Sign-On. La password può contenere da 8 a 20 caratteri e deve includere almeno una lettera maiuscola, almeno una lettera minuscola, almeno un numero e almeno un carattere speciale, ad esempio un segno di dollaro ($), un cancelletto (#), una chiocciola (@), un punto (.) o un punto esclamativo (!). Tutti i caratteri devono essere caratteri ASCII. |
domain_name |
stringa | Nome di dominio di vCenter Single Sign-On, ad esempio vsphere.local. Se si distribuisce un'appliance vCenter Server come prima istanza in un nuovo dominio di vCenter Single Sign-On, è necessario impostare il nome del nuovo dominio di vCenter Single Sign-On. |
replication_partner_hostname |
stringa | Nome di sistema del partner vCenter Server. Richiesto solo se si distribuisce un partner di replica in un dominio di vCenter Single Sign-On esistente. |
sso_port |
numero intero | Porta del proxy inverso HTTPS del partner vCenter Server. La porta predefinita è 443. Utilizzare solo se il partner utilizza una porta del proxy inverso HTTPS personalizzata. |
Parametri di configurazione nella sezione ceip
Nome | Tipo | Descrizione |
---|---|---|
ceip_enabled |
Booleano | Impostare su true per partecipare al Programma di Miglioramento dell'Esperienza del Cliente di VMware per questa appliance. |