Actualizar el dispositivo de VMware Cloud Director mediante un paquete de actualización

Con la ayuda de un paquete de actualización, puede actualizar el dispositivo de VMware Cloud Director a la versión más reciente o aplicar revisiones al dispositivo de VMware Cloud Director.

Mientras se actualiza la implementación del dispositivo de VMware Cloud Director, el servicio de VMware Cloud Director deja de funcionar y se puede esperar que exista un periodo de inactividad. Este periodo depende del tiempo que se necesite para actualizar cada dispositivo de VMware Cloud Director y ejecutar el script de actualización de la base de datos de VMware Cloud Director. La cantidad de celdas en funcionamiento en el grupo de servidores de VMware Cloud Director se reduce hasta que detenga el servicio de VMware Cloud Director en el último dispositivo de VMware Cloud Director. Un equilibrador de carga configurado correctamente delante de los endpoints HTTP de VMware Cloud Director debería dejar de enrutar el tráfico a las celdas que están detenidas.

Después de aplicar la actualización a cada dispositivo de VMware Cloud Director y después de que se complete la actualización de la base de datos, debe reiniciar cada dispositivo de VMware Cloud Director.

Requisitos previos

Realice una instantánea del dispositivo de VMware Cloud Director principal.

Si aplica una revisión o actualiza la versión 10.1 u otra posterior, y está habilitada la conmutación por error automática en caso de error en el servicio de base de datos principal, cambie el modo de conmutación por error a Manual durante la actualización. Después de la actualización, puede establecer el modo de conmutación por error en Automatic. Consulte la Conmutación por error automática del dispositivo de VMware Cloud Director.
Inicie sesión en la instancia de vCenter Server en la que reside el dispositivo de VMware Cloud Director principal del clúster de alta disponibilidad de la base de datos.
Desplácese hasta el dispositivo de VMware Cloud Director principal, haga clic con el botón derecho en él y, a continuación, haga clic en Alimentación > Desconectar SO invitado.
Haga clic con el botón derecho en el dispositivo y haga clic en Instantáneas > Realizar instantánea. Introduzca un nombre y, si lo desea, una descripción para la instantánea. Después, haga clic en Siguiente.
Haga clic con el botón derecho en el dispositivo de VMware Cloud Director y haga clic en Alimentación > Encender.
Compruebe que todos los nodos de la configuración de alta disponibilidad de la base de datos estén en buen estado. Consulte la Ver el estado del clúster y el modo de conmutación por error del dispositivo de VMware Cloud Director.
Familiarícese con el procedimiento de copia de seguridad del dispositivo de VMware Cloud Director. Consulte la Hacer una copia de seguridad de la base de datos integrada del dispositivo de VMware Cloud Director.

Procedimiento

En un navegador web, inicie sesión en la interfaz de usuario de administración de dispositivos de una instancia del dispositivo de VMware Cloud Director para identificar el dispositivo principal, https://dirección_IP_de_dispositivo:5480.
Anote el nombre del dispositivo principal. Debe actualizar el dispositivo principal antes que las celdas en espera y de aplicación. Debe usar el dispositivo principal al realizar una copia de seguridad de la base de datos.
En todos los dispositivos del clúster, para apagar VMware Cloud Director, ejecute el siguiente comando:
```
/opt/vmware/vcloud-director/bin/cell-management-tool -u <admin_username> cell --shutdown
```
Descargue el paquete de actualización en el dispositivo que se va a actualizar.

Nota: Primero debe actualizar el dispositivo principal.
VMware Cloud Director se distribuye como un archivo ejecutable con un nombre del tipo VMware_Cloud_Director_v.v.v.v- nnnnnnnn_update. tar.gz, donde v. v. v. v representa la versión de producto y nnnnnnnn representa el número de compilación. Por ejemplo, VMware_Cloud_Director_10.1.0.4424-14420378_update.tar.gz.
Cree el directorio local-update-package en el que se extraerá el paquete de actualización.
```
mkdir /tmp/local-update-package
```

Extraiga el paquete de actualización en el directorio que acaba de crear.

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

Establezca el directorio local-update-package como el repositorio de actualización.
```
vamicli	update --repo file:///tmp/local-update-package
```
Busque actualizaciones para comprobar que el repositorio se estableció correctamente.
```
vamicli update --check
```
La versión de la actualización aparece como una actualización disponible.
Cree una copia de seguridad mediante la interfaz de usuario de administración del dispositivo principal o en espera.
No puede utilizar la celda de aplicación para realizar una copia de seguridad.
Aplique la actualización disponible.
```
vamicli update --install latest
```
Repita los pasos del 3 al 7 y el paso 9 en las celdas restantes en espera y de aplicación.
En cualquier dispositivo, ejecute la utilidad upgrade de la base de datos de VMware Cloud Director.
```
/opt/vmware/vcloud-director/bin/upgrade
```
Reinicie cada dispositivo de VMware Cloud Director.
```
shutdown -r now
```

Qué hacer a continuación

Compruebe que la actualización se ha realizado correctamente.
- Inicie sesión en VMware Cloud Director Service Provider Admin Portal.
- Inicie sesión en la interfaz de usuario de administración de dispositivos de VMware Cloud Director y confirme que todos los dispositivos se muestran con un estado Healthy.
Compruebe que los registros no muestran ningún error de conversión de certificados durante la actualización. Si hay errores de conversión de certificados en los registros, no se puede realizar una copia de seguridad del dispositivo de VMware Cloud Director. Si aparece algún error, no vuelva a intentar la actualización y, en función del error, solucione el problema manualmente antes de volver a ejecutar el comando de conversión.
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates --convert
```
Existen diferentes soluciones alternativas en función del error, por ejemplo:
- Si aparece la siguiente excepción en /opt/vmware/var/log/vami/updatecli.log durante el proceso de conversión de los certificados, consulte el artículo 88372 de la base de conocimientos.
```
 <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 el /opt/vmware/var/log/vami/updatecli.log tiene errores del proceso de conversión de los certificados relacionados con una clave incorrecta o, si no indica ninguna razón para los errores, las posibles soluciones alternativas son las siguientes:
  - Si no hay ningún archivo .pem ni .key listo, compruebe que existe el archivo de almacén de claves. Puede encontrar la ubicación del archivo del almacén de claves en el archivo global.properties.
  - Si VMware Cloud Director encuentra el archivo de almacén de claves, extraiga los archivos .pem y .key mediante la utilidad keytool o la herramienta OpenSSL.
  - Si VMware Cloud Director no encuentra el archivo de almacén de claves, vuelva a configurar los certificados por completo. Para obtener más información acerca de crear certificados, consulte Creación y administración de certificados SSL del dispositivo de VMware Cloud Director.
  - Si existen archivos .pem y .key relacionados con los certificados comodín, para reemplazar los certificados existentes en el nodo por los certificados comodín, utilice el comando certificate de la herramienta de administración de celdas.
```
/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 actualización se realiza correctamente, puede eliminar la instantánea del dispositivo de VMware Cloud Director.
Si, por el contrario, la actualización no se realiza correctamente, puede revertir el dispositivo de VMware Cloud Director a la instantánea que realizó antes de la actualización. Consulte la Revertir el dispositivo de VMware Cloud Director a la versión anterior cuando se produce un error en una actualización.