Atualizar manualmente o dispositivo virtual do Horizon Cloud Connector

Para obter os recursos mais recentes para os pods do Horizon conectados à nuvem, atualize o dispositivo virtual do Horizon Cloud Connector desses pods para a versão mais recente. Este artigo descreve as etapas para atualizar manualmente o dispositivo virtual no ambiente no qual ele é implantado.

Visão geral do processo de atualização do Horizon Cloud Connector

Você não precisará realizar uma atualização manual se a sua conta de tenant Horizon Cloud estiver configurada para atualizações automatizadas do Horizon Cloud Connector. Com o recurso de atualização automatizada, o dispositivo será automaticamente atualizado da camada de nuvem quando a equipe de operações do Horizon Cloud disponibilizar uma nova versão para a sua conta de tenant. Para obter detalhes, consulte Configurar atualizações automatizadas do dispositivo virtual do Horizon Cloud Connector.

Uma versão existente pode ser atualizada para uma ou duas versões posteriores. Ou seja, a versão N pode ser atualizada para ou N+1``N+2.

Observação: A configuração SSL do proxy não é suportada durante uma atualização do dispositivo virtual do Horizon Cloud Connector.

Ao planejar o upgrade do Horizon Cloud Connector e do Servidor de conexão de um pod do Horizon conectado à nuvem, monitore e verifique a integridade desse pod durante o processo de upgrade. O monitoramento da integridade do pod pode ajudar a solucionar quaisquer problemas que possam surgir. Às vezes, fazer upgrade do Servidor de conexão em um pod do Horizon conectado à nuvem pode resultar em problemas com a integridade desse pod. Se, em seguida, tentar atualizar o Horizon Cloud Connector emparelhado com esse pod não íntegro, o upgrade do Horizon Cloud Connector poderá falhar. Siga esta prática recomendada:

1. Depois de fazer upgrade do Servidor de conexão do pod do Horizon conectado à nuvem, verifique a integridade desse pod.
2. Para exibir o status de integridade do pod, primeiro faça login no Horizon Universal Console e realize um Active Directory BIND de domínio. Essa etapa permite que você acesse a página Capacidade do console, na qual é possível verificar se o pod mostra um status de integridade Online ou Pronto.
3. Se o pod exibir um status não íntegro, entre em contato com Horizon Cloud suporte para obter ajuda para resolver qualquer problema de conectividade que envolva o pod antes de tentar fazer upgrade do Horizon Cloud Connector.

Fluxo de trabalho de atualização manual para o Horizon Cloud Connector 1.10 ou anterior

Para um dispositivo existente do Horizon Cloud Connector que esteja executando a versão 1.10 ou anterior, siga o procedimento descrito neste artigo para executar a atualização manual.

Fluxo de trabalho de atualização manual para o Horizon Cloud Connector 2.0 ou posterior

Para um dispositivo existente do Horizon Cloud Connector que esteja executando a versão 2.0 ou posterior, o fluxo de trabalho de atualização manual varia de acordo com o fato de você ter implantado um cluster de nó único ou de vários nós.

• Se você tiver implantado um cluster de nó único que consiste apenas em um nó primário, siga o procedimento descrito neste artigo para executar a atualização manual.
• Se você tiver implantado um cluster de vários nós que consiste em um nó primário e um ou mais nós de trabalhador, use o seguinte fluxo de trabalho para executar a atualização manual.
  1. Siga o procedimento descrito neste artigo para realizar a atualização manual do nó primário.
  2. Siga o procedimento descrito em Horizon Cloud Connector 2.0 e posterior: adicionar um nó de trabalhador a um cluster do Horizon Cloud Connector para adicionar a versão atualizada do nó de trabalhador ao cluster.
  3. Desligue as versões antigas do nó primário e do nó de trabalhador e remova-as do ambiente do seu pod.

Pré-requisitos

• Baixe a versão mais recente do dispositivo virtual do Horizon Cloud Connector compatível com a versão atual da camada de controle na nuvem. Para obter a versão atual e as informações de lançamento, consulte as Notas de versão.

• Verifique se o novo dispositivo virtual do Horizon Cloud Connector e o dispositivo virtual existente do Horizon Cloud Connector que precisam da atualização estão na mesma rede para que o novo dispositivo virtual possa estabelecer uma comunicação SSH com o dispositivo virtual existente.

• Verifique se o dispositivo virtual está ligado. Seria incomum se o dispositivo estivesse desligado, pois o Horizon Cloud Connector deve manter uma conexão com a camada de controle de nuvem para garantir que sua licença de assinatura do Horizon permaneça ativa para o pod conectado à nuvem.

• Quando certificados assinados por CA personalizados forem configurados no armazenamento de confiança do Horizon Cloud Connector para sua desativação de tráfego SSL de saída e, em seguida, você atualizar do Horizon Cloud Connector versão 2.4.0 para versões posteriores, depois que o novo dispositivo estiver pronto, você deverá copiar manualmente os certificados personalizados para o novo dispositivo e executar as etapas descritas em Quando você tiver o descarregamento de SSL configurado para o tráfego de saída, configure seus certificados assinados pela CA personalizada para permitir conexões com a camada de controle do Horizon. Os certificados não são transferidos automaticamente do dispositivo virtual anterior para o novo dispositivo virtual.

  Importante: Antes de atualizar, você deve salvar cópias de backup dos certificados do diretório do dispositivo /opt/container-data/hydracerts/ e salvá-las em um local temporário. Salvar as cópias permite que você as copie para o novo dispositivo após a atualização. Como o dispositivo existente foi encerrado, você não poderá recuperar os certificados depois disso. Portanto, você deve obter os certificados desse diretório antes de iniciar o upgrade e salvá-los em um local temporário de onde possa recuperá-los para carregá-los no novo dispositivo quando ele estiver pronto.

• (Pods do SDDC Horizon no local e integrados) Use vSphere Client para tirar um snapshot do dispositivo virtual do Horizon Cloud Connector existente.

• (Pods do Horizon no AVS com arquitetura federada) Use um dos métodos a seguir para tirar um snapshot do appliance virtual do Horizon Cloud Connector existente.

  • Para obter instruções sobre como usar o portal do Azure ou o PowerShell para tirar um snapshot do dispositivo, consulte https://docs.microsoft.com/en-us/azure/virtual-machines/windows/snapshot-copy-managed-disk.
  • Para obter instruções sobre como criar um backup de VM do dispositivo, consulte https://docs.microsoft.com/en-us/azure/backup/backup-azure-vms-introduction.

• Obtenha o endereço IP estático, o endereço DNS, o endereço do gateway e a máscara de sub-rede para o dispositivo virtual do Horizon Cloud Connector.

• Garanta que você tenha credenciais de conta do Customer Connect válidas para fazer logon na sua conta de tenant da camada de controle. Conforme descrito nas informações de integração no Guia de implantação, use essa conta para fazer login no portal de integração e gerenciamento do Horizon Cloud Connector. Se o domínio Active Directory associado do pod já estiver registrado no tenant Horizon Cloud ao qual o conector está emparelhado, uma segunda tela de login aparecerá depois que você fizer login com suas credenciais do Customer Connect. Essa segunda tela de logon solicita as credenciais de Active Directory de um administrador que tenha a função de superadministrador no ambiente de tenant do Horizon Cloud. Se você vir essa segunda tela de logon, precisará das credenciais para uma conta de Active Directory nesse domínio que tenha permissões de acesso. Para obter uma descrição desse processo de login, consulte Fazer login no Horizon Universal Console para executar tarefas de gerenciamento no seu ambiente Horizon Cloud.

• (Pods do SDDC Horizon no local e integrados) Adicione o FQDN do vCenter Server ao /etc/hosts arquivo no dispositivo virtual do Horizon Cloud Connector. Esse FQDN é necessário para que essas etapas de atualização manual funcionem.

  Para o Cloud Connector versão 2.0 ou posterior: depois de editar o arquivo, você deve reiniciar os serviços do /etc/hosts Kubernetes. Localize o arquivo chamado configure-adapter.py no sistema de arquivos do Horizon Cloud Connector. Para o Horizon Cloud Connector versão 2.4.1 e versões anteriores 2.x, o configure-adapter.py arquivo está localizado em um bin diretório dentro da estrutura de /opt diretórios. Para o Horizon Cloud Connector versão 2.5, o script está localizado no /opt/horizon/bin diretório.

  Altere para esse diretório e execute o seguinte script:

  ```
  configure-adapter.py  --updateHostAlias
  ```
  

Importante: A versão 1.0 do dispositivo do conector não é mais suportada. Se você estiver atualizando da versão 1.0, deverá fazer logon no sistema operacional do dispositivo e executar o comando no dispositivo virtual do Horizon Cloud Connector após tirar o chage -E -1 -M -1 tomcat8 snapshot.

root@example.com [ ~ ]# chage -E -1 -M -1 tomcat8

Esse comando é necessário somente ao atualizar do Horizon Cloud Connector versão 1.0 e não para a atualização a partir de versões posteriores.

Procedimento

1. Quando você estiver atualizando do Horizon Cloud Connector versão 2.4.0 para versões posteriores e certificados assinados por CA personalizados são configurados no armazenamento de confiança do Horizon Cloud Connector, salve cópias de backup dos certificados do /opt/container-data/hydracerts/ diretório do dispositivo e salve-as em um local temporário de onde você possa recuperá-las para carregá-las no novo dispositivo quando estiver pronto.

2. Em um navegador da Web, para fazer logon no portal de integração e gerenciamento do Horizon Cloud Connector, digite o endereço IP do appliance virtual do Horizon Cloud Connector ou, se tiver mapeado esse IP para um FQDN no DNS, insira esse FQDN no navegador.

   Use suas credenciais de conta do Customer Connect para fazer login. Com essa etapa, você faz logon em sua conta de tenant do Horizon Cloud, conforme descrito no processo de integração no Guia de implantação. Um logon bem-sucedido verifica se a conexão do Horizon Cloud existente foi configurada com êxito com o Servidor de Conexão do pod conectado à nuvem. Se o seu tenant Horizon Cloud tiver um domínio Active Directory registrado, uma segunda tela de login será exibida. Se isso acontecer, insira as credenciais de Active Directory apropriadas, conforme descrito em Fazer login no Horizon Universal Console para executar tarefas de gerenciamento no seu ambiente Horizon Cloud.

3. Implante a versão do dispositivo virtual do Horizon Cloud Connector para o qual você está atualizando, conforme descrito nas etapas de 1 a 8 de Conectar o Horizon Cloud a um pod existente do Horizon para usar licenças de assinatura ou serviços hospedados na nuvem do Horizon ou ambos.

   Observação: Se a instância anterior do dispositivo virtual do Horizon Cloud Connector usava um proxy HTTP, redefina as configurações de proxy seguindo os prompts no assistente de implantação. As configurações de proxy não são transferidas do dispositivo virtual anterior para o novo dispositivo virtual durante uma atualização manual.

4. Faça logon no portal de integração do dispositivo do Horizon Cloud Connector que você acabou de implantar na etapa 2 usando seu endereço IP no navegador.

   Faça login com suas credenciais do Customer Connect conforme descrito na etapa 1 acima. Se a sua conta de tenant do Horizon Cloud tiver um domínio de Active Directory registrado, a janela de Active Directory de login será exibida, e você precisará fazer logon com as credenciais de Active Directory apropriadas.

5. Conecte esse dispositivo Horizon Cloud Connector que você acabou de implantar com a instância apropriada do Servidor de Conexão.

   A versão anterior do Horizon Cloud Connector está conectada à instância do Servidor de conexão do pod conectado à nuvem. Na caixa Conexão com o Horizon Connection Server , insira o FQDN do Servidor de Conexão e clique em Conectar.

6. Se a exibição solicitar verificação do certificado de impressão digital, clique na caixa de seleção para verificar o certificado de impressão digital para o Servidor de Conexão.

   Observação: Essa verificação será ignorada se o Servidor de Conexão tiver um certificado de Autoridade de Certificação Raiz válido.

7. Digite o nome de domínio, o nome de usuário e a senha do Servidor de Conexão, e clique em Conectar.

   Observação: Para melhor auditoria das ações do Horizon Cloud Connector, use um nome de usuário e uma senha exclusivos para o Servidor de Conexão.

8. Ao atualizar para o Horizon Cloud Connector versão 1.5, ative a alternância Ativar o SSH no Cloud Connector .

   A ativação do SSH permite que o novo dispositivo do conector se comunique por SSH com o existente para o processo de atualização. Quando a atualização for concluída, você poderá desativar essa alternância.

9. Clique em Atualizar na caixa de diálogo.

10. Na caixa de texto Endereço do Cloud Connector Antigo , insira o endereço IP do dispositivo virtual anterior do Horizon Cloud Connector e clique em Conectar.

11. Clique na caixa de seleção para verificar a impressão digital da conexão SSH.

12. Clique em Upgrade.

    Agora o novo Horizon Cloud Connector está gerenciando a conexão de nuvem entre o pod do Horizon e a camada de controle da nuvem.

O que fazer agora

Se a instância anterior do dispositivo virtual do Horizon Cloud Connector usava certificados assinados pela CA personalizados, configure o dispositivo virtual atualizado com as cópias de backup que você salvou na Etapa 1. Os certificados não são transferidos do dispositivo virtual anterior para o novo dispositivo virtual durante o processo de atualização. Para obter mais informações, consulte Configurar um certificado assinado pela autoridade de certificação para o appliance virtual do Horizon Cloud Connector.

• Se você tiver atualizado para Horizon Cloud versão 2.4.x ou posterior do Connector, poderá usar as etapas descritas em Quando você tiver o descarregamento de SSL configurado para o tráfego de saída, configure seus certificados assinados pela CA personalizados para permitir conexões com a camada de controle do Horizon.
• Se você tiver atualizado para uma versão anterior à 2.4.0, use as etapas em Configurar um certificado assinado pela autoridade de certificação para o dispositivo virtual do Horizon Cloud Connector.

Remova a versão antiga do dispositivo do ambiente do seu pod.