Aggiornamento dell'appliance di VMware Cloud Director mediante un pacchetto di aggiornamento

È possibile aggiornare l'appliance di VMware Cloud Director alla versione più recente o applicare patch all'appliance di VMware Cloud Director mediante un pacchetto di aggiornamento.

Durante l'aggiornamento della distribuzione dell'appliance VMware Cloud Director, il servizio VMware Cloud Director smette di funzionare e può verificarsi un po' di tempo di inattività. Il tempo di inattività dipende dal tempo necessario per aggiornare ogni appliance VMware Cloud Director e per eseguire lo script di aggiornamento del database VMware Cloud Director. Il numero di celle funzionanti nel gruppo di server VMware Cloud Director si riduce finché non si arresta il servizio VMware Cloud Director nell'ultima appliance VMware Cloud Director. Un bilanciamento del carico configurato correttamente davanti agli endpoint HTTP di VMware Cloud Director dovrebbe interrompere il routing del traffico verso le celle arrestate.

Dopo aver applicato l'aggiornamento a ogni appliance di VMware Cloud Director e completato l'aggiornamento del database, è necessario riavviare ogni appliance di VMware Cloud Director.

Prerequisiti

Creare uno snapshot dell'appliance primaria di VMware Cloud Director.

Quando si esegue l'aggiornamento dalla versione 10.1 o successiva o quando si applicano patch, se il failover automatico in caso di errore del servizio di database primario è abilitato, impostare la modalità di failover su Manual durante l'aggiornamento. Dopo l'aggiornamento, è possibile impostare la modalità di failover su Automatic. Vedere Failover automatico dell'appliance di VMware Cloud Director.
Accedere all'istanza di vCenter Server in cui si trova l'appliance primaria di VMware Cloud Director del cluster ad alta disponibilità del database.
Passare all'appliance primaria di VMware Cloud Director, fare clic con il pulsante destro del mouse sull'appliance e scegliere Attiva > Spegni sistema operativo guest.
Fare clic con il pulsante destro del mouse sull'appliance e scegliere Snapshot > Crea snapshot. Digitare un nome e, facoltativamente, una descrizione per lo snapshot, quindi fare clic su OK.
Fare clic con il pulsante destro del mouse sull'appliance VMware Cloud Director e scegliere Attiva > Attiva.
Verificare che tutti i nodi della configurazione a disponibilità elevata del database funzionino correttamente. Vedere Visualizzazione della modalità di failover e dell'integrità del cluster dell'appliance di VMware Cloud Director.
Familiarizzare con la procedura di backup per l'appliance di VMware Cloud Director. Vedere Backup del database incorporato dell'appliance di VMware Cloud Director incorporata.

Procedura

In un browser Web, accedere all'interfaccia utente di gestione dell'appliance di un'istanza dell'appliance VMware Cloud Director per identificare l'appliance primaria, https://appliance_ip_address:5480.
Prendere nota del nome dell'appliance primaria. È necessario aggiornare l'appliance primaria prima delle celle di standby e dell'applicazione. Quando si esegue il backup del database, è necessario utilizzare l'appliance primaria.
In tutte le appliance del cluster, arrestare VMware Cloud Director eseguendo il comando seguente:
```
/opt/vmware/vcloud-director/bin/cell-management-tool -u <admin_username> cell --shutdown
```
Scaricare il pacchetto di aggiornamento nell'appliance che si sta aggiornando.

Nota: È necessario aggiornare prima l'appliance primaria.
VMware Cloud Director è distribuito come file eseguibile con nome del modulo VMware_Cloud_Director_v.v.v.v- nnnnnnnn_update. tar.gz, dove v. v. v. v rappresenta la versione di prodotto e nnnnnnnn il numero di build. Ad esempio, VMware_Cloud_Director_10.1.0.4424-14420378_update.tar.gz.
Creare la directory local-update-package in cui estrarre il pacchetto di aggiornamento.
```
mkdir /tmp/local-update-package
```

Estrarre il pacchetto di aggiornamento nella directory appena creata.

 tar -zxf VMware_Cloud_Director_v.v.v.v-nnnnnnnn_update.tar.gz \
				-C /tmp/local-update-package

Impostare la directory local-update-package come repository di aggiornamento.
```
vamicli	update --repo file:///tmp/local-update-package
```
Controllare la disponibilità degli aggiornamenti per verificare che il repository sia stato stabilito correttamente.
```
vamicli update --check
```
La versione dell'aggiornamento viene visualizzata come Aggiornamento disponibile.
Creare un backup utilizzando l'interfaccia utente di gestione dell'appliance primaria o di standby.
Non è possibile utilizzare la cella dell'applicazione per eseguire un backup.
Applicare l'aggiornamento disponibile.
```
vamicli update --install latest
```
Ripetere i passaggi da 3 a 7 e il passaggio 9 nelle celle di standby e dell'applicazione rimanenti.
Da qualsiasi appliance, eseguire l'utilità di upgrade del database di VMware Cloud Director.
```
/opt/vmware/vcloud-director/bin/upgrade
```
Riavviare ciascuna appliance VMware Cloud Director.
```
shutdown -r now
```

Operazioni successive

Verificare che l'aggiornamento sia stato eseguito correttamente.
- Accedere al VMware Cloud Director Service Provider Admin Portal.
- Accedere all'interfaccia utente di gestione dell'appliance di VMware Cloud Director e verificare che tutte le appliance vengano visualizzate con stato Healthy.
Verificare che nei registri non siano presenti errori di conversione dei certificati durante l'aggiornamento. Se nei registri sono presenti errori di conversione del certificato, non è possibile eseguire il backup dell'appliance VMware Cloud Director. Se vengono visualizzati errori, non tentare di nuovo l'aggiornamento e, in base all'errore, risolvere il problema manualmente prima di eseguire nuovamente il comando di conversione.
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates --convert
```
In base all'errore, esistono diverse soluzioni, ad esempio:
- Se in /opt/vmware/var/log/vami/updatecli.log viene visualizzata la seguente eccezione durante il processo di conversione dei certificati, consultare l'articolo 88372 della Knowledge Base.
```
 <JAVA_HOME>/lib/ext exists, extensions mechanism no longer supported; Use -classpath instead.
             .Error: Could not create the Java Virtual Machine.
              Error: A fatal exception has occurred. Program will exit. 
```
- Se opt/vmware/var/log/vami/updatecli.log include errori del processo di conversione dei certificati correlati a una chiave non valida o se non indica alcun motivo per gli errori, le soluzioni possibili sono le seguenti:
  - Se non sono pronti file .pem e .key, verificare che il file dell'archivio chiavi esista. La posizione del file dell'archivio chiavi è disponibile nel file global.properties.
  - Se VMware Cloud Director trova il file dell'archivio chiavi, estrarre i file .pem e .key dall'archivio chiavi tramite l'utilità keytool o lo strumento OpenSSL.
  - Se VMware Cloud Director non trova il file dell'archivio chiavi, riconfigurare completamente i certificati. Per ulteriori informazioni sulla creazione dei certificati, vedere Creazione e gestione del certificato SSL dell'appliance di VMware Cloud Director.
  - Se sono presenti file .pem e .key relativi ai certificati con caratteri jolly, per sostituire i certificati esistenti nel nodo con i certificati con caratteri jolly, utilizzare il comando del certificato dello strumento di gestione delle celle.
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -j --cert /opt/vmware/vcloud-director/data/transfer/user.http.pem --key /opt/vmware/vcloud-director/data/transfer/user.http.key --key-password key_password
/opt/vmware/vcloud-director/bin/cell-management-tool certificates -p --cert /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.pem --key /opt/vmware/vcloud-director/data/transfer/user.consoleproxy.key --key-password key_password
```
Se l'aggiornamento riesce, è possibile eliminare lo snapshot dell'appliance VMware Cloud Director.
Se l'aggiornamento non viene eseguito correttamente, è possibile eseguire il rollback dell'appliance VMware Cloud Director allo snapshot creato prima dell'aggiornamento. Vedere Rollback di un'appliance di VMware Cloud Director quando un aggiornamento non riesce.