Preparazione del file di configurazione JSON per l'upgrade tramite CLI

Prima di eseguire il comando CLI per l'upgrade di un vCenter Server Appliance, è necessario preparare un file JSON con i parametri di configurazione e i relativi valori per la specifica di upgrade.

Il programma di installazione di vCenter Server contiene modelli JSON per tutti i tipi di upgrade. Per informazioni sui modelli, vedere Modelli JSON per l'upgrade tramite CLI dell'appliance vCenter Server.

È possibile eseguire l'upgrade di un'appliance con configurazioni minime impostando i valori sui parametri di configurazione nel modello JSON per la propria 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 upgrade --template-help oppure vedere Aggiornamento dei parametri di configurazione per l'aggiornamento tramite CLI di vCenter Server Appliance.

Prerequisiti

• È necessario conoscere la sintassi JSON.
• Download e montaggio del programma di installazione di vCenter Server.

Procedura

1. Nel programma di installazione di vCenter Server Appliance, passare alla directory vcsa-cli-installer e aprire la sottocartella templates.
2. Copiare i modelli di upgrade dalla sottocartella upgrade all'area di lavoro.
   Importante: Il percorso dei file di configurazione JSON deve contenere solo caratteri ASCII. I caratteri ASCII estesi e i caratteri non ASCII non sono supportati.
3. Aprire il file del modello per il proprio caso d'uso in un editor di testo.
   Per garantire la sintassi corretta del file di configurazione JSON, utilizzare un editor JSON.
4. Inserire i valori per i parametri di configurazione necessari e, facoltativamente, immettere i parametri aggiuntivi e i rispettivi valori.
   Ad esempio, se si desidera utilizzare un'assegnazione DHCP IPv4 per la rete temporanea della nuova appliance, nella sottosezione temporary_network del modello, modificare il valore del parametro mode in dhcp e rimuovere i parametri di configurazione predefiniti per un'assegnazione statica.

           "temporary_network": {
               "ip_family": "ipv4",
               "mode": "dhcp"
           },

   Importante: 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, "image":"G:\\vcsa\\VMware-vCenter-Server-Appliance-6.7.0.XXXX-YYYYYYY_OVF10.ova" imposta il percorso G:|vcsa|VMware-vCenter-Server-Appliance-6.7.0. XXXX-YYYYYYY_OVF10.ova.

   I valori booleani devono contenere solo caratteri minuscoli, ovvero un valore può essere true o false. Ad esempio "ssh_enable":false.

5. (Facoltativo) Utilizzare un editor JSON prescelto per convalidare il file JSON.
6. Salvare in formato UTF-8 e chiudere il file.

Operazioni successive

È possibile creare e salvare modelli aggiuntivi, se necessario per la specifica di upgrade.

Modelli JSON per l'upgrade tramite CLI dell'appliance vCenter Server

Il programma di installazione dell'appliance vCenter Server contiene i modelli JSON che si trovano nella directory vcsa-cli-installer/templates. Nella sottocartella upgrade è possibile trovare i modelli JSON con i parametri di configurazione minimi per tutti i tipi di upgrade.

Per ogni tipo di upgrade sono presenti un modello per la distribuzione della nuova appliance in un host ESXi e un altro modello per la distribuzione della nuova appliance in un'istanza di vCenter Server.

Tabella 1. Modelli JSON di upgrade inclusi nel programma di installazione di vCenter Server Appliance

Indirizzo	Modello	Descrizione
vcsa-cli-installer\templates\upgrade\vcsa\6.7	embedded_vCSA_on_ESXi.json	Contiene i parametri di configurazione minimi necessari per l'upgrade di vCenter Server Appliance 6.7 con un'istanza di Platform Services Controller incorporata in vCenter Server Appliance 8.0 in un host ESXi.
	embedded_vCSA_on_VC.json	Contiene i parametri di configurazione minimi necessari per l'upgrade di vCenter Server Appliance 6.7 con un'istanza di Platform Services Controllerincorporata in vCenter Server Appliance 8.0 in un'istanza di vCenter Server.
	vCSA_on_ESXi.json	Contiene i parametri di configurazione minimi necessari per l'upgrade di vCenter Server Appliance 6.7 con un'istanza di Platform Services Controller esterna a vCenter Server Appliance 8.0 in un host ESXi.
	vCSA_on_VC.json	Contiene i parametri di configurazione minimi necessari per l'upgrade di vCenter Server Appliance 6.7 con un'istanza di Platform Services Controller esterna a vCenter Server Appliance 8.0 in un'istanza di vCenter Server.
vcsa-cli-installer\templates\upgrade\vcsa\7.0	embedded_vCSA_on_ESXi.json	Contiene i parametri di configurazione minimi necessari per l'upgrade di vCenter Server Appliance 7.0 con un'istanza di Platform Services Controller incorporata in vCenter Server Appliance 8.0 in un host ESXi.
	embedded_vCSA_on_VC.json	Contiene i parametri di configurazione minimi necessari per l'upgrade di vCenter Server Appliance 7.0 con un'istanza di Platform Services Controller incorporata a vCenter Server Appliance8.0 in un'istanza di vCenter Server.

Informazioni sull'aggiornamento di un'appliance vCenter Server con un Platform Services Controller esterno tramite CLI

Quando si esegue l'upgrade di un vCenter Server Appliance che utilizza un Platform Services Controller esterno, questa viene convertita in un'istanza di vCenter Server con tali servizi già incorporati. Per tale motivo, è necessario specificare i parametri dei partner di replica nei modelli di upgrade JSON.

Quando si esegue l'upgrade di un vCenter Server Appliance che utilizza un Platform Services Controller esterno, è necessario specificare i parametri dei partner di replica nel modello di upgrade JSON. Questi parametri indicano se l'upgrade riguarda uno dei seguenti scenari di upgrade di vCenter Server e Platform Services Controller.

• Una singola istanza di vCenter Server e Platform Services Controller in un dominio SSO.
• La prima istanza di vCenter Server e Platform Services Controller in un dominio SSO contenente più istanze di vCenter Server.
• La replica delle istanze di vCenter Server e Platform Services Controller in un dominio SSO, che è necessario impostare perché punti a un'istanza di vCenter Server 7.0 esistente come partner di replica.

Importante: Non è possibile eseguire l'upgrade di un'istanza di Platform Services Controller esterna. Il processo di upgrade fa convergere i servizi dell'istanza di Platform Services Controller in vCenter Server Appliance. Per ulteriori informazioni, vedere Rimozione di Platform Services Controller.

Le distribuzioni che utilizzano un Platform Services Controller esterno vengono spesso definite MxN, dove M rappresenta vCenter Server e N rappresenta il Platform Services Controller esterno. Quando si rappresentano più istanze di vCenter Server e Platform Services Controller in un dominio, la distribuzione viene definita MnxNn, dove n è il numero di istanze. Ad esempio, M2xN2 indica due istanze di vCenter Server e due istanze di Platform Services Controller all'interno dello stesso dominio. Per l'upgrade di tale distribuzione, si effettua innanzitutto l'upgrade di un'istanza alla versione 8.0, quindi si esegue l'upgrade della seconda istanza a 8.0, specificando la prima delle due istanze come partner di replica.

I parametri di replica nel modello di upgrade JSON si trovano nella sezione sso e sono first_instance e replication_partner_hostname.

Nome parametro	Descrizione
first_instance	Il parametro first_instance identifica vCenter Server come prima istanza nel dominio SSO di vCenter Server o come partner di replica. Se si tratta della prima istanza di vCenter Server, impostare first_instance su true. Per le altre istanze di vCenter Server nello stesso dominio SSO, impostare first_instance su false.
replication_partner_hostname*	Se si imposta first_instance su false, è necessario specificare FQDN o IP di un'istanza di vCenter Server di cui è già stato eseguito l'upgrade alla versione 8.0 e il cui PSC esterno è stato fatto convergere nell'appliance vCenter Server.

Quando si esegue l'upgrade tramite CLI di un singolo vCenter Server Appliance che utilizza un Platform Services Controller esterno, il processo è il seguente:

1. Eseguire l'upgrade dell'istanza di vCenter Server nella topologia, utilizzando il modello vCSA_on_ESXi.json per l'upgrade in ESXi o il modello vCSA_on_VC.json per l'upgrade nelle distribuzioni di vCenter Server.

2. Per una topologia di distribuzione composta da una singola istanza di vCenter Server e Platform Services Controller (distribuzione M1xN1), modificare la sezione sso del modello in modo che il parametro first_instance sia impostato su true e rimuovere il parametro replication_partner_hostname.

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. Specificare i restanti parametri di configurazione dell'upgrade nel modello JSON ed eseguire l'upgrade di vCenter Server alla versione 8.0 mediante CLI. Vedere Aggiornamento di un'appliance vCenter Server mediante CLI.
4. Dopo aver correttamente aggiornato vCenter Server, eseguire la dismissione di Platform Services Controller. Vedere Dismissione di Platform Services Controller.
   Importante: Eseguire la dismissione delle istanze di Platform Services Controller solo dopo l'aggiornamento e la convergenza di tutte le istanze di vCenter Server nella topologia.

Per una distribuzione composta da due o più istanze di vCenter Server e Platform Services Controller (distribuzione M2xN2), è innanzitutto necessario eseguire l'upgrade dell'istanza M1 di vCenter Server alla versione 8.0, per poi procedere all'upgrade della seconda istanza, replicando l'istanza di vCenter Server.

1. Eseguire l'upgrade delle istanze di vCenter Server nella distribuzione, utilizzando il modello vCSA_on_ESXi.json per l'upgrade in ESXi o il modello vCSA_on_VC.json per l'upgrade nelle distribuzioni di vCenter Server.

2. Per la prima istanza di vCenter Server ( M1), modificare la sezione sso del modello in modo che il parametro first_instance sia impostato su true e rimuovere il parametro replication_partner_hostname.

   "sso": {
   "__comments": [ This is the first instance (M1) vCenter Server management node, with "first_instance" set to "true" and "replication_partner_hostname" removed.
   ],
   "first_instance": true
   }

3. Per l'istanza di vCenter Server rimanente ( M2), modificare la sezione sso del modello in modo che il parametro first_instance sia impostato su false e specificare FQDN o IP dell'istanza di vCenter Server in cui si desidera replicare il secondo nodo. Il partner di replica è la prima istanza di vCenter Server ( M1) di cui è stato eseguito l'upgrade alla versione 8.0, che è stata fatta convergere con l'istanza di Platform Services Controller.

   "sso": {
   "__comments": [ This is the second instance (M2) vCenter Server management node, with "first_instance" set to "false" and "replication_partner_hostname" set to the hostname of the replication partner.],
   "first_instance": false,
   "replication_partner_hostname": "FQDN_or_IP_address"

4. Specificare i restanti parametri di configurazione dell'upgrade nei modelli JSON e completare l'upgrade mediante CLI. Vedere Aggiornamento di un'appliance vCenter Server mediante CLI.
5. Dopo aver correttamente aggiornato tutte le istanze di vCenter Server nella topologia, eseguire la dismissione delle istanze di Platform Services Controller. Vedere Dismissione di Platform Services Controller.
   Importante: Eseguire la dismissione delle istanze di Platform Services Controller solo dopo l'aggiornamento e la convergenza di tutte le istanze di vCenter Server nella topologia.

Aggiornamento dei parametri di configurazione per l'aggiornamento tramite CLI di vCenter Server Appliance

Quando si preparano i file di configurazione JSON per l'aggiornamento tramite CLI, è necessario impostare parametri e valori per fornire dati di input per l'aggiornamento di vCenter Server Appliance.

Sezioni e sottosezioni dei parametri di configurazione nei file di aggiornamento JSON

I parametri di configurazione nei file di configurazione JSON per l'aggiornamento tramite CLI sono organizzati in sezioni e sottosezioni.

Tabella 2. Sezioni e sottosezioni dei parametri di configurazione nei file di aggiornamento JSON

Sezione	Sottosezione	Descrizione
new_vcsa: descrive la nuova appliance che si desidera distribuire.	esxi	Utilizzare solo se si desidera distribuire la nuova appliance direttamente in un host ESXi. Contiene i parametri di configurazione che descrivono l'host ESXi di destinazione. Vedere Parametri di configurazione nella sezione new_vcsa, sottosezione esxi. Nota: È necessario compilare questa sottosezione o la sottosezione vc.
	vc	Utilizzare solo se si desidera distribuire la nuova 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 new_vcsa, sottosezione vc. Nota: È necessario compilare questa sottosezione o la sottosezione esxi. L'istanza di vCenter Server di destinazione non può essere l'istanza di vCenter Server Appliance che si desidera aggiornare. In questi casi, utilizzare la sottosezione esxi.
	appliance	Contiene i parametri di configurazione che descrivono la nuova appliance. Vedere Parametri di configurazione nella sezione new_vcsa, sottosezione appliance
	os	Contiene solo il parametro di configurazione ssh_enable per impostare l'accesso dell'amministratore SSH per la nuova appliance.
	ovftool_arguments	Facoltativo. Utilizzare questa sottosezione per aggiungere argomenti arbitrari e relativi valori al comando OVF Tool generato dal programma di installazione. Importante: Il programma di installazione di vCenter Server Appliance 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.
	temporary_network	Contiene i parametri di configurazione che descrivono le impostazioni di rete temporanee per la nuova appliance. Vedere Parametri di configurazione nella sezione new_vcsa, sottosezione temporary_network
	user_options	Contiene solo il parametro di configurazione vcdb_migrateSet per impostare i tipi di dati che si desidera trasferire dall'appliance precedente alla nuova appliance. Vedere Parametri di configurazione nella sezione new_vcsa, sottosezione user_options
source_vc: descrive l'appliance esistente che si desidera aggiornare.	managing_esxi_or_vc	Contiene i parametri di configurazione che descrivono l'host ESXi o l'istanza di vCenter Server Appliance di origine in cui si trova l'appliance che si desidera aggiornare. Vedere Parametri di configurazione nella sezione source_vc, sottosezione managing_esxi_or_vc.
	vc_vcsa	Contiene i parametri di configurazione che descrivono l'appliance di origine che si desidera aggiornare. Vedere Parametri di configurazione nella sezione source_vc, sottosezione vc_vcsa.
source_vum: descrive l'istanza di VMware Update Manager di origine. Utilizzare se si desidera eseguire automaticamente Assistente migrazione nell'istanza di VMware Update Manager.	run_migration_assistant	Facoltativa se l'istanza di vCenter Server Appliance di origine che si desidera aggiornare è connessa a un'istanza di VMware Update Manager eseguita in una macchina virtuale Windows. Utilizzare questa sottosezione se si desidera eseguire automaticamente Assistente migrazione nell'istanza di VMware Update Manager di origine. Contiene i parametri di configurazione che descrivono l'istanza di VMware Update Manager di origine, che verrà migrata nella nuova istanza di vCenter Server Appliance aggiornata. Vedere Parametri di configurazione nella sezione source_vum, sottosezione run_migration_assistant. Nota: Per impostazione predefinita Migration Assistant utilizza la porta 9123. Se la porta 9123 è utilizzata da un altro servizio nella macchina Update Manager, Migration Assistant trova automaticamente un'altra porta libera. Non è possibile impostare una porta personalizzata per Migration Assistant.
ceip: indica come partecipare al programma Analisi utilizzo software di VMware.	settings	Contiene solo il parametro di configurazione ceip_enabled per la partecipazione o meno al Programma di Miglioramento dell'Esperienza del Cliente di VMware. Vedere Parametri di configurazione nella sezione ceip, sottosezione settings. Necessaria solo se si aggiorna un'istanza di vCenter Server Appliance con un'istanza di Platform Services Controller incorporata o un'appliance Platform Services Controller. Nota: Se il parametro di configurazione ceip_enabled è impostato su true, è necessario eseguire il comando relativo alla 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.

Importante: 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, "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. Il valore può essere true o false. Ad esempio "ssh_enable":false.

Parametri di configurazione nella sezione new_vcsa

Tabella 3. Parametri di configurazione nella sezione new_vcsa, sottosezione esxi

Nome	Tipo	Descrizione
hostname	stringa	Indirizzo IP o FQDN dell'host ESXi di destinazione in cui si desidera distribuire la nuova 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 la nuova appliance. La rete deve far parte dell'host ESXi o dell'istanza di vCenter Server Appliance di destinazione (come stabilito dal parametro di configurazione managing_esxi_or_vc). Nota: La rete deve essere accessibile dall'host ESXi o dall'istanza di vCenter Server Appliance di origine (così stabilito dal parametro di configurazione managing_esxi_or_vc) in cui si trova l'appliance che si desidera aggiornare. La rete deve essere accessibile anche dalla macchina client da cui si esegue l'aggiornamento. Questo parametro viene ignorato se l'host ESXi di destinazione ha una sola rete.
datastore	stringa	Nome del datastore in cui archiviare i file di configurazione delle macchine virtuali e i dischi virtuali della nuova appliance. Il datastore deve essere disponibile per l'host ESXi di destinazione. Nota: Il datastore deve avere almeno 25 GB di spazio libero.
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.
ssl_certificate_verification	stringa	La CLI verifica che il certificato di sicurezza di un server sia firmato da un'autorità di certificazione (CA) e stabilisce una connessione sicura. Se il certificato è autofirmato, la CLI interrompe l'aggiornamento, a meno che non si specifichi una delle seguenti opzioni di configurazione del certificato SSL: Specificare l'identificazione personale del certificato SHA-1 (Secure Hash Algorithm 1). L'identificazione personale di un certificato è una stringa esadecimale che identifica il certificato in modo univoco. L'identificazione personale viene calcolata dal contenuto del certificato utilizzando un apposito algoritmo. "thumbprint": "certificate SHA-1 thumbprint" Impostare verification_mode su NONE. "verification_mode": "NONE" Se ci si connette a un server con un certificato autofirmato e non si specifica l'identificazione personale del certificato SHA-1 o non si imposta la modalità di verifica su NONE, la CLI visualizza l'identificazione personale del certificato autofirmato del server e chiede di accettare o rifiutare l'identificazione personale del certificato. È inoltre possibile specificare che la CLI ignori il certificato autofirmato utilizzando il parametro --no-ssl-certificate-validation del comando vcsa-deploy upgrade. Vedere Sintassi del comando CLI di upgrade.

Tabella 4. Parametri di configurazione nella sezione new_vcsa, sottosezione vc

Nome	Tipo	Descrizione
hostname	stringa	Indirizzo IP o FQDN dell'istanza di vCenter Server di destinazione in cui si desidera distribuire la nuova 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 la nuova appliance. La rete deve far parte della configurazione di rete del cluster DRS o dell'host ESXi di destinazione. Nota: La rete deve essere accessibile dall'host ESXi di origine in cui si trova l'appliance che si desidera aggiornare. La rete deve essere accessibile anche dalla macchina client da cui si esegue l'aggiornamento. 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 il cluster DRS o l'host ESXi di destinazione in cui si desidera distribuire la nuova 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"] Se nel data center non è presente alcun percorso di cartella, utilizzare solo il nome del data center. Ad esempio, ["datacenter_name"] o "datacenter_name" Nota: Per questo valore viene fatta distinzione tra maiuscole e minuscole.
datastore	stringa	Nome del datastore in cui si desidera archiviare tutti i file di configurazione delle macchine virtuali e i dischi virtuali della nuova appliance. Nota: Il datastore deve essere disponibile per il cluster DRS o l'host ESXi di destinazione. 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	Cluster, host ESXi o pool di risorse di destinazione in cui si desidera distribuire la nuova appliance. Si tratta della destinazione specificata con il parametro datacenter. Questo percorso deve terminare con il nome del cluster, dell'host ESXi o del pool di risorse. 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. Nota: Per tutti i valori viene fatta distinzione tra maiuscole e minuscole. Se si desidera che l'appliance distribuita sia elencata in una posizione diversa all'interno della gerarchia del data center, utilizzare il parametro vm_folder descritto più avanti in questa sezione. Se il cluster, l'host ESXi o il pool di risorse di destinazione 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"] Se la distribuzione viene eseguita in un pool di risorse, includere l'etichetta Resources prima del nome del pool di risorse. Ad esempio: ["cluster_name", "Resources", "resource_pool_name"] Nota: Le verifiche preliminari controllano solo la memoria del pool di risorse.
vm_folder	stringa	Facoltativo. Nome della cartella della macchina virtuale in cui aggiungere la nuova appliance.

Tabella 5. Parametri di configurazione nella sezione new_vcsa, sottosezione appliance

Nome	Tipo	Descrizione
thin_disk_mode	Booleano	Impostare su true per distribuire la nuova appliance con dischi virtuali thin.
deployment_option	stringa	Dimensioni della nuova appliance. Nota: È necessario considerare le dimensioni del database dell'appliance che si desidera aggiornare. Per un database esterno, vedere Determinazione delle dimensioni del database Oracle e dello storage per la nuova appliance. Impostare su tiny se si desidera distribuire un'appliance di vCenter Server per un massimo di 10 host e 100 macchine virtuali con le dimensioni di storage predefinite. Distribuisce un'appliance con 2 CPU, 10 GB di memoria e 300 GB di storage. Impostare su tiny-lstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 10 host e 100 macchine virtuali con grandi dimensioni di storage. Distribuisce un'appliance con 2 CPU, 10 GB di memoria e 825 GB di storage. Impostare su tiny-xlstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 10 host e 100 macchine virtuali con dimensioni di storage molto grandi. Distribuisce un'appliance con 2 CPU, 10 GB di memoria e 1700 GB di storage. Impostare su small se si desidera distribuire un'appliance di vCenter Server per un massimo di 100 host e 1.000 macchine virtuali con le dimensioni di storage predefinite. Distribuisce un'appliance con 4 CPU, 16 GB di memoria e 340 GB di storage. Impostare su small-lstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 100 host e 1.000 macchine virtuali con grandi dimensioni di storage. Distribuisce un'appliance con 4 CPU, 16 GB di memoria e 870 GB di storage. Impostare su small-xlstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 100 host e 1.000 macchine virtuali con dimensioni di storage molto grandi. Distribuisce un'appliance con 4 CPU, 16 GB di memoria e 1750 GB di storage. Impostare su medium se si desidera distribuire un'appliance di vCenter Server per un massimo di 400 host e 4.000 macchine virtuali con le dimensioni di storage predefinite. Distribuisce un'appliance con 8 CPU, 24 GB di memoria e 525 GB di storage. Impostare su medium-lstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 400 host e 4.000 macchine virtuali con grandi dimensioni di storage. Distribuisce un'appliance con 8 CPU, 24 GB di memoria e 1025 GB di storage. Impostare su medium-xlstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 400 host e 4.000 macchine virtuali con dimensioni di storage molto grandi. Distribuisce un'appliance con 8 CPU, 24 GB di memoria e 1905 GB di storage. Impostare su large se si desidera distribuire un'appliance di vCenter Server per un massimo di 1.000 host e 10.000 macchine virtuali con le dimensioni di storage predefinite. Distribuisce un'appliance con 16 CPU, 32 GB di memoria e 740 GB di storage. Impostare su large-lstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 1.000 host e 10.000 macchine virtuali con grandi dimensioni di storage. Distribuisce un'appliance con 16 CPU, 32 GB di memoria e 1090 GB di storage. Impostare su large-xlstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 1.000 host e 10.000 macchine virtuali con dimensioni di storage molto grandi. Distribuisce un'appliance con 16 CPU, 32 GB di memoria e 1970 GB di storage. Impostare su xlarge se si desidera distribuire un'appliance di vCenter Server per un massimo di 2.000 host e 35.000 macchine virtuali con le dimensioni di storage predefinite. Distribuisce un'appliance con 24 CPU, 48 GB di memoria e 1180 GB di storage. Impostare su xlarge-lstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 2.000 host e 35.000 macchine virtuali con grandi dimensioni di storage. Distribuisce un'appliance con 24 CPU, 48 GB di memoria e 1230 GB di storage. Impostare su xlarge-xlstorage se si desidera distribuire un'appliance di vCenter Server per un massimo di 2.000 host e 35.000 macchine virtuali con dimensioni di storage molto grandi. Distribuisce un'appliance con 24 CPU, 48 GB di memoria e 2110 GB di storage. Impostare su management-tiny se si desidera distribuire un'istanza di vCenter Server Appliance con un'istanza di Platform Services Controller esterna per un massimo di 10 host e 100 macchine virtuali con dimensioni di storage predefinite. Distribuisce un'appliance con 2 CPU, 10 GB di memoria e 300 GB di storage.
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 la nuova 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.
license	stringa	Facoltativo. Chiave di licenza da applicare all'appliance. Se la chiave di licenza non viene fornita, verrà utilizzata la licenza di valutazione.

Tabella 6. Parametri di configurazione nella sezione new_vcsa, sottosezione temporary_network

Nome	Tipo	Descrizione
ip_family	stringa	Versione IP della rete temporanea della nuova appliance. Impostare su ipv4 o ipv6.
mode	stringa	Assegnazione dell'IP per la rete temporanea della nuova appliance. Impostare su static o dhcp.
ip	stringa	Indirizzo IP temporaneo per la nuova appliance. Obbligatorio solo se si utilizza un'assegnazione statica, ovvero se si imposta il parametro mode su static. È necessario impostare un indirizzo IPv4 o IPv6 che corrisponda alla versione IP della rete temporanea, ovvero al valore del parametro ip.family. 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 la rete temporanea della nuova appliance. 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" Necessario solo se si utilizza la modalità di rete statica per l'allocazione dell'indirizzo IP temporaneo, ovvero se si imposta il parametro mode su static.
prefix	stringa	Lunghezza del prefisso di rete per la rete temporanea della nuova appliance. Utilizzare solo se il parametro mode è impostato su static. Rimuovere se il parametro mode è impostato su dhcp. 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 0 e 32. Per la versione IPv6, il valore deve essere compreso tra 0 e 128.
gateway	stringa	Indirizzo IP del gateway predefinito della rete temporanea della nuova appliance. Per la versione IPv6, il valore può essere default.

Tabella 7. Parametri di configurazione nella sezione new_vcsa, sottosezione user_options

Nome	Tipo	Descrizione
vcdb_migrateSet	stringa	Selezionare i tipi di dati da migrare dalla vecchia alla nuova appliance. I dati vengono copiati dall'istanza di vCenter Server di origine al server di destinazione. L'origine iniziale dei dati resta invariata. Impostare su core se si desidera trasferire solo i dati di configurazione. Questa opzione consente di migrare i dati più rapidamente, riducendo al minimo il tempo di inattività del sistema. Impostare su core_events_tasks se si desidera trasferire immediatamente i dati di configurazione e cronologici (eventi e attività). vCenter Server verrà avviato solo dopo la migrazione di tutti i dati dall'istanza di vCenter Server Appliance di origine. Impostare su all se si desidera trasferire immediatamente i dati relativi alla configurazione, alla cronologia e alle metriche delle prestazioni. vCenter Server verrà avviato solo dopo la migrazione di tutti i dati dal sistema vCenter Server per Windows di origine. Questa opzione consente di trasferire la quantità massima di dati e richiede un periodo di inattività maggiore rispetto alle altre opzioni di migrazione dei dati. Impostare su transfer_events_tasks_after_upgrade se si desidera trasferire i dati cronologici (eventi e attività) in background al termine dell'aggiornamento. Durante questo periodo di tempo, le prestazioni di vCenter Server potrebbero non essere ottimali. Impostare su transfer_stats_events_tasks_after_upgrade se si desidera trasferire i dati relativi a cronologia e metriche delle prestazioni in background al termine dell'aggiornamento. Durante questo periodo di tempo, le prestazioni di vCenter Server potrebbero non essere ottimali. Nota: Per ridurre al minimo il tempo di aggiornamento e la quantità di storage necessaria per la nuova istanza di vCenter Server Appliance, utilizzare il valore core. Per ulteriori informazioni sui tipi di dati che è possibile trasferire dall'istanza di vCenter Server esistente alla nuova istanza di vCenter Server aggiornata, vedere Trasferimento dei dati da un'istanza di vCenter Server Appliance esistente.

Tabella 8. Parametri di configurazione nella sezione new_vcsa, sottosezione sso

Nome	Tipo	Descrizione
first_instance	stringa	Impostare first_instance su true se questa è la prima operazione di aggiornamento convergente nel dominio SSO di vCenter Server o se non si desidera impostare il partner di replica per questo nodo. Se si desidera impostare il partner di replica per questo nodo, impostare first_instance su false e specificare il valore di replication_partner_hostname come FQDN di un nodo fatto precedentemente convergere che si trova attualmente in una topologia di vCenter Server incorporata. Per ulteriori informazioni sulla specifica dei parametri first_instance e replication_partner_hostname, vedere Informazioni sull'aggiornamento di un'appliance vCenter Server con un Platform Services Controller esterno tramite CLI.
replication_partner_hostname	stringa	Nome host del partner di replica. Rimuovere se il valore è first_instance.

Parametri di configurazione nella sezione source_vc

Tabella 9. Parametri di configurazione nella sezione source_vc, sottosezione managing_esxi_or_vc

Nome	Tipo	Descrizione
hostname	stringa	Indirizzo IP o FQDN dell'host ESXi o vCenter Server di origine in cui si trova l'appliance che si desidera aggiornare.
username	stringa	Nome utente con privilegi amministrativi nell'host ESXi di origine, ad esempio root.
password	stringa	Password dell'utente con privilegi amministrativi nell'host ESXi di origine.
port	numero intero	Porta del proxy inverso HTTPS dell'host ESXi di origine. La porta predefinita è 443. Utilizzare solo se l'host ESXi di origine utilizza una porta del proxy inverso HTTPS personalizzata.

Tabella 10. Parametri di configurazione nella sezione source_vc, sottosezione vc_vcsa

Nome	Tipo	Descrizione
hostname	stringa	Indirizzo IP o FQDN dell'appliance di origine che si desidera aggiornare.
username	stringa	Utente amministratore di vCenter Single Sign-On nell'appliance di origine, ad esempio [email protected]. Importante: L'utente deve essere administrator@ your_domain_name.
password	stringa	Password dell'utente amministratore di vCenter Single Sign-On nell'appliance di origine.
root_password	stringa	Password dell'utente root del sistema operativo dell'appliance di origine.
export_dir	stringa	Directory in cui esportare la configurazione e i dati di origine.

Parametri di configurazione nella sezione source.vum

Tabella 11. Parametri di configurazione nella sezione source_vum, sottosezione run_migration_assistant

Nome	Tipo	Descrizione
esxi_hostname	stringa	Indirizzo IP o FQDN dell'host ESXi in cui si trova l'istanza di VMware Update Manager di origine. Se viene specificato un FQDN, questo deve essere risolvibile dalla macchina client da cui si esegue l'upgrade.
esxi_username	stringa	Nome utente con privilegi amministrativi nell'host ESXi, ad esempio root.
esxi_password	stringa	Password dell'utente con privilegi amministrativi nell'host ESXi.
esxi_port	stringa	Porta del proxy inverso HTTPS dell'host ESXi. La porta predefinita è 443. Utilizzare solo se l'host ESXi usa una porta del proxy inverso HTTPS personalizzata.
vum_hostname	stringa	Indirizzo IP o FQDN della macchina virtuale Windows in cui è in esecuzione l'istanza di VMware Update Manager di origine. Se viene specificato un FQDN, questo deve essere risolvibile dalla macchina client da cui si esegue l'upgrade.
vum_os_username	stringa	Nome utente dell'amministratore della macchina virtuale Windows in cui è in esecuzione l'istanza di VMware Update Manager di origine.
vum_os_password	stringa	Password amministratore della macchina virtuale Windows in cui viene eseguita l'istanza di VMware Update Manager di origine. Se questo valore non viene specificato, viene chiesto di immettere la password nella console dei comandi durante la verifica del modello.
export_dir	stringa	Directory in cui esportare la configurazione e i dati di origine.

Parametri di configurazione nella sezione ceip

Tabella 12. Parametri di configurazione nella sezione ceip, sottosezione settings

Nome	Tipo	Descrizione
ceip_enabled	Booleano	Impostare su true per partecipare al programma Analisi utilizzo software per la nuova appliance aggiornata.