Fazer upgrade do dispositivo do VMware Cloud Director usando um pacote de atualização

Você pode fazer upgrade do dispositivo do VMware Cloud Director para a versão mais recente ou aplicar patches ao dispositivo do VMware Cloud Director usando um pacote de atualização.

Durante o upgrade da implantação do dispositivo do VMware Cloud Director, o serviço VMware Cloud Director para de funcionar, e um certo tempo de inatividade pode ser esperado. O tempo de inatividade depende do tempo necessário para fazer upgrade de cada dispositivo do VMware Cloud Director e executar o script de atualização do banco de dados VMware Cloud Director. O número de células de trabalho no grupo de servidores VMware Cloud Director será reduzido até que você pare o serviço VMware Cloud Director no último dispositivo VMware Cloud Director. Um balanceador de carga configurado adequadamente na frente dos endpoints HTTP do VMware Cloud Director deve parar o roteamento do tráfego para as células que estão paradas.

Depois de aplicar o upgrade a cada dispositivo do VMware Cloud Director e o upgrade do banco de dados estiver concluído, você deverá reinicializar cada dispositivo do VMware Cloud Director.

Pré-requisitos

Tire um instantâneo do dispositivo primário do VMware Cloud Director.

Ao fazer upgrade da versão 10.1 ou posterior ou ao aplicar patches, se o failover automático no caso de uma falha no serviço de banco de dados primário estiver ativado, altere o modo de failover para Manual durante o upgrade. Após o upgrade, você pode definir o modo de failover como Automatic. Consulte Failover automático do dispositivo do VMware Cloud Director.
Faça login na instância do vCenter Server na qual reside o dispositivo primário do VMware Cloud Director do seu cluster de alta disponibilidade do banco de dados.
Navegue até o dispositivo primário do VMware Cloud Director, clique com o botão direito do mouse nele e clique em Ligar/Desligar > Encerrar SO Convidado.
Clique com o botão direito do mouse no dispositivo e clique em Instantâneo > Tirar Instantâneo. Insira um nome e, opcionalmente, uma descrição para o instantâneo e clique em OK.
Clique com o botão direito do mouse no dispositivo do VMware Cloud Director e clique em Ligar/Desligar > Ligar.
Verifique se todos os nós na configuração de alta disponibilidade do banco de dados estão em bom estado. Consulte Visualizar o modo de integridade e failover do cluster do dispositivo do VMware Cloud Director.
Familiarize-se com o procedimento de backup para o dispositivo do VMware Cloud Director. Consulte Fazer backup do banco de dados incorporado do dispositivo VMware Cloud Director.

Procedimento

Em um navegador da Web, faça login na interface do usuário de gerenciamento do dispositivo de uma instância de dispositivo VMware Cloud Director para identificar o dispositivo primário, https://appliance_ip_address:5480.
Anote o nome do dispositivo primário. Você deve fazer o upgrade do dispositivo primário antes das células em modo de espera e de aplicativos. Você deverá usar o nome do dispositivo primário ao fazer backup do banco de dados.
Em todos os dispositivos do cluster, desligue VMware Cloud Director executando o seguinte comando:
```
/opt/vmware/vcloud-director/bin/cell-management-tool -u <admin_username> cell --shutdown
```
Faça o download do pacote de atualização referente ao dispositivo para o qual você deseja fazer o upgrade.

Observação: Primeiro, você deve fazer o upgrade do dispositivo primário.
O VMware Cloud Director é distribuído como um arquivo executável com um nome no formato VMware_Cloud_Director_v.v.v.v- nnnnnnnn_update. tar.gz, em que v. v. v. v representa a versão do produto e nnnnnnnn, o número da compilação. Por exemplo, VMware_Cloud_Director_10.1.0.4424-14420378_update.tar.gz.
Crie o diretório local-update-package para extrair o pacote de atualização.
```
mkdir /tmp/local-update-package
```

Extraia o pacote de atualização no diretório recém-criado.

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

Defina o diretório local-update-package como o repositório de atualização.
```
vamicli	update --repo file:///tmp/local-update-package
```
Verifique se há atualizações para conferir se você estabeleceu corretamente o repositório.
```
vamicli update --check
```
A versão do upgrade aparece como Atualização Disponível.
Crie um backup usando a UI de gerenciamento do dispositivo primário ou em espera.
Não é possível usar a célula do aplicativo para realizar um backup.
Aplique o upgrade disponível.
```
vamicli update --install latest
```
Repita as etapas 3 a 7 e a etapa 9 nas células de espera e de aplicativo restantes.
Em qualquer dispositivo, execute o utilitário upgrade do banco de dados VMware Cloud Director.
```
/opt/vmware/vcloud-director/bin/upgrade
```
Reinicie cada dispositivo do VMware Cloud Director.
```
shutdown -r now
```

O que Fazer Depois

Verifique se o upgrade foi bem-sucedido.
- Faça login no VMware Cloud Director Service Provider Admin Portal.
- Faça login na UI do gerenciamento do dispositivo do VMware Cloud Director e confirme se todos os aparelhos aparecem com um status Healthy.
Verifique se os logs não mostram nenhum erro de conversão de certificado durante o upgrade. Se houver erros de conversão de certificado nos logs, você não poderá fazer backup do dispositivo do VMware Cloud Director. Se aparecer algum erro, não tente fazer upgrade novamente e, dependendo do erro, corrija o problema manualmente antes de executar o comando de conversão novamente.
```
/opt/vmware/vcloud-director/bin/cell-management-tool certificates --convert
```
Existem diferentes soluções alternativas dependendo do erro, por exemplo:
- Se a exceção a seguir aparecer no /opt/vmware/var/log/vami/updatecli.log durante o processo de conversão dos certificados, consulte KB artigo 88372.
```
 <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 o /opt/vmware/var/log/vami/updatecli.log tiver erros do processo de conversão dos certificados relacionados a uma chave incorreta ou se não informar o motivo das falhas, possíveis soluções alternativas são:
  - Se não houver arquivos .pem e .key prontos, verifique se o arquivo de armazenamento de chaves existe. Você pode encontrar a localização do arquivo de armazenamento de chaves no arquivo global.properties.
  - Se o VMware Cloud Director encontrar o arquivo de armazenamento de chaves, extraia os arquivos .pem e .key do armazenamento de chaves usando a utilidade keytool ou a ferramenta do OpenSSL.
  - Se o VMware Cloud Director não encontrar o arquivo armazenamento de chaves, reconfigure totalmente os certificados. Para saber mais sobre como criar certificados, consulte Criação e gerenciamento de certificado SSL do dispositivo do VMware Cloud Director.
  - Se houver arquivos .pem e .key relacionados aos certificados curinga, para substituir os certificados existentes no nó pelos certificados curinga, use o comando certificado da ferramenta de gerenciamento de células.
```
/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 o upgrade for bem-sucedido, você poderá excluir o snapshot do dispositivo do VMware Cloud Director.
Se o upgrade não for bem-sucedido, você poderá reverter o dispositivo do VMware Cloud Director para o snapshot que tirou antes do upgrade. Consulte Reverter um dispositivo do VMware Cloud Director quando um upgrade falhar.