Mettre à niveau votre dispositif VMware Cloud Director à l'aide d'un module de mise à jour

Vous pouvez mettre à niveau votre dispositif VMware Cloud Director vers la dernière version ou appliquer des correctifs à votre dispositif VMware Cloud Director à l'aide d'un module de mise à jour.

Pendant la mise à niveau du dispositif VMware Cloud Director, le service VMware Cloud Director cesse de fonctionner et une interruption de service est à prévoir. L'interruption de service dépend du temps nécessaire pour mettre à niveau chaque dispositif VMware Cloud Director et pour exécuter le script de mise à niveau de la base de données VMware Cloud Director. Le nombre de cellules de travail dans le groupe de serveurs VMware Cloud Director diminue jusqu'à ce que vous arrêtiez le service VMware Cloud Director sur le dernier dispositif VMware Cloud Director. Un équilibrage de charge correctement configuré devant les points de terminaison HTTP VMware Cloud Director doit arrêter le routage du trafic vers les cellules qui sont arrêtées.

Après l'application de la mise à niveau sur chaque dispositif VMware Cloud Director et une fois la mise à niveau de la base de données terminée, vous devez redémarrer chaque dispositif VMware Cloud Director.

Conditions préalables

Prenez un snapshot du dispositif VMware Cloud Director principal.

Lors de la mise à niveau de la version 10.1 ou ultérieure ou de l'application de correctifs, si le basculement automatique en cas d'échec du service de base de données principal est activé, passez le mode de basculement sur Manual pendant la mise à niveau. Après la mise à niveau, vous pouvez définir le mode de basculement sur Automatic. Reportez-vous à la section Basculement automatique de votre dispositif VMware Cloud Director.
Connectez-vous à l'instance de vCenter Server sur laquelle réside le dispositif VMware Cloud Director principal de votre cluster haute disponibilité de base de données.
Accédez au dispositif VMware Cloud Director principal, cliquez sur lui avec le bouton droit, puis cliquez sur Alimentation > Arrêter le SE invité.
Cliquez sur le dispositif avec le bouton droit, puis cliquez sur Snapshots > Prendre un snapshot . Entrez un nom et, éventuellement, une description pour le snapshot, puis cliquez sur OK.
Cliquez avec le bouton droit sur le dispositif VMware Cloud Director, puis cliquez sur Alimentation > Mettre sous tension.
Vérifiez que tous les nœuds de votre configuration haute disponibilité de la base de données sont en bon état. Reportez-vous à la section Afficher la santé et le mode de basculement du cluster de votre dispositif VMware Cloud Director.
Familiarisez-vous avec la procédure de sauvegarde du dispositif VMware Cloud Director. Reportez-vous à la section Sauvegarder la base de données intégrée de votre dispositif VMware Cloud Director.

Procédure

Dans un navigateur Web, connectez-vous à l'interface utilisateur de gestion de dispositif d'une instance du dispositif VMware Cloud Director pour identifier le dispositif principal, https://appliance_ip_address:5480.
Notez le nom du dispositif principal. Vous devez mettre à niveau le dispositif principal avant les cellules de veille et d'application. Vous devez utiliser le nom du dispositif principal lors de la mise à niveau de la base de données.
Sur tous les dispositifs du cluster, arrêtez VMware Cloud Director en exécutant la commande suivante :
```
/opt/vmware/vcloud-director/bin/cell-management-tool -u <admin_username> cell --shutdown
```
Téléchargez le module de mise à jour sur le dispositif que vous mettez à niveau.

Note : Vous devez d'abord mettre à niveau le dispositif principal.
VMware Cloud Director est distribué sous la forme d'un fichier exécutable avec un nom au format VMware_Cloud_Director_v.v.v.v- nnnnnnnn_update. tar.gz, où v. v. v. v représente la version du produit et nnnnnnnn le numéro de build. Par exemple, VMware_Cloud_Director_10.1.0.4424-14420378_update.tar.gz.
Créez le répertoire local-update-package dans lequel extraire le module de mise à jour.
```
mkdir /tmp/local-update-package
```

Extrayez le module de mise à jour dans le répertoire qui vient d'être créé.

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

Définissez le répertoire local-update-package comme référentiel de mise à jour.
```
vamicli	update --repo file:///tmp/local-update-package
```
Contrôlez les mises à jour pour vérifier que vous avez correctement établi le référentiel.
```
vamicli update --check
```
La version de la mise à niveau s'affiche sous la forme d'une Mise à jour disponible.
Créez une sauvegarde à l'aide de l'interface utilisateur de gestion du dispositif principal ou en veille.
Vous ne pouvez pas utiliser la cellule d'application pour effectuer une sauvegarde.
Appliquez la mise à niveau disponible.
```
vamicli update --install latest
```
Répétez les étapes 3 à 7 et 9 sur les cellules en veille et d'application restantes.
Depuis n'importe quel dispositif, exécutez l'utilitaire upgrade de la base de données VMware Cloud Director.
```
/opt/vmware/vcloud-director/bin/upgrade
```
Redémarrez chaque dispositif VMware Cloud Director.
```
shutdown -r now
```

Que faire ensuite

Vérifiez que la mise à niveau a réussi.
- Connectez-vous à VMware Cloud Director Service Provider Admin Portal.
- Connectez-vous à l'interface utilisateur de gestion des dispositifs VMware Cloud Director et vérifiez que tous les dispositifs s'affichent avec un état Healthy.
Vérifiez que les journaux n'affichent aucune erreur de conversion de certificat pendant la mise à niveau. S'il existe des erreurs de conversion de certificat dans les journaux, vous ne pouvez pas sauvegarder le dispositif VMware Cloud Director. Si des erreurs s'affichent, ne recommencez pas la mise à niveau et, en fonction de l'erreur, corrigez le problème manuellement avant d'exécuter à nouveau la commande convert.
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates --convert
```
Il existe différentes solutions en fonction de l'erreur, par exemple :
- Si l'exception suivante s'affiche dans /opt/vmware/var/log/vami/updatecli.log pendant le processus de conversion des certificats, reportez-vous à l'article 88372 de la base de connaissances.
```
 <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. 
```
- Si le fichier /opt/vmware/var/log/vami/updatecli.log présente des erreurs du processus de conversion des certificats liées à une clé incorrecte ou n'indique aucune raison pour les échecs, les solutions possibles sont les suivantes :
  - Si aucun fichier .pem et .key n'est prêt, vérifiez que le fichier keystore existe. Vous trouverez l'emplacement du fichier keystore dans le fichier global.properties.
  - Si VMware Cloud Director trouve le fichier keystore, extrayez les fichiers .pem et .key à l'aide de l'utilitaire keytool ou de l'outil OpenSSL.
  - Si VMware Cloud Director ne trouve pas le fichier keystore, reconfigurez entièrement les certificats. Pour en savoir plus sur la création de certificats, reportez-vous à la section Création et gestion de certificats SSL de votre dispositif VMware Cloud Director.
  - S'il existe des fichiers .pem et .key liés aux certificats génériques, pour remplacer les certificats existants sur le nœud par des certificats génériques, utilisez la commande de l'outil de gestion des cellules des certificats.
```
/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
```
Si la mise à niveau réussit, vous pouvez supprimer le snapshot du dispositif VMware Cloud Director.
Si la mise à niveau échoue, vous pouvez restaurer le dispositif VMware Cloud Director sur le snapshot que vous avez pris avant la mise à niveau. Reportez-vous à la section Restaurer votre dispositif VMware Cloud Director en cas d'échec d'une mise à niveau.