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 do 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 da VMware disponibilizar uma nova versão para a sua conta de tenant. Para obter detalhes, consulte Configurar atualizações automatizadas do dispositivo virtual 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 N+1 ou 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 na integridade desse pod. Em seguida, se você tentar fazer upgrade do 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 da integridade do pod, primeiro faça login no Horizon Universal Console e realize um BIND de domínio do Active Directory. 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 mostrar um status não íntegro, entre em contato com o suporte da VMware 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 do Horizon Cloud Connector existente 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 do Horizon Cloud Connector existente 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 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. Para obter a versão atual e as informações de lançamento, consulte as Notas da versão na página de documentação do Horizon Cloud.
  • 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 Se você tiver o SSL de desativação configurado para o tráfego de saída, configure seus certificados assinados pela autoridade de certificação personalizados 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 /opt/container-data/hydracerts/ do dispositivo 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 estiver pronto.
  • (Pods do SDDC Horizon no local e integrados) Use o vSphere Client para tirar um instantâneo do dispositivo virtual do Horizon Cloud Connector existente.
  • (Pods do Horizon no Azure VMware Solution com arquitetura federada) Use um dos métodos a seguir para tirar um snapshot do dispositivo virtual do Horizon Cloud Connector existente.
  • 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 logon no portal de integração e gerenciamento do Horizon Cloud Connector. Se o domínio do Active Directory associado do pod já estiver registrado no tenant Horizon Cloud ao qual o conector está emparelhado, uma segunda tela de logon aparecerá depois que você fizer logon com suas credenciais do My VMware. Essa segunda tela de logon solicita as credenciais do 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 do Active Directory nesse domínio que tenha permissões de acesso. Para obter uma descrição desse processo de logon, consulte Fazer login no Horizon Universal Console para executar tarefas de gerenciamento no ambiente do Horizon Cloud.
  • (Pods do SDDC Horizon no local e integrados) Adicione o FQDN do vCenter Server ao arquivo /etc/hosts 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 1.10 ou anterior, depois de editar o arquivo /etc/hosts, você deve reiniciar os serviços hze-core e csms. Use os seguintes comandos:

    systemctl restart hze-core
systemctl restart csms
    Para o Cloud Connector versão 2.0 ou posterior, depois de editar o arquivo /etc/hosts, você deve reiniciar os serviços do Kubernetes. Execute o seguinte script:
    /opt/vmware/bin/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 login no sistema operacional do dispositivo e executar o comando chage -E -1 -M -1 tomcat8 no dispositivo virtual do Horizon Cloud Connector após tirar o snapshot. 
[email protected] [ ~ ]# chage -E -1 -M -1 tomcat8
Esse comando é necessário somente ao atualizar da versão 1.0 do Horizon Cloud Connector 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 diretório /opt/container-data/hydracerts/ 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 dispositivo 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 existente do Horizon Cloud foi configurada com êxito com o Servidor de Conexão do pod conectado à nuvem. Se o seu tenant do Horizon Cloud tiver um domínio registrado do Active Directory, será exibida uma segunda tela de logon. Se isso acontecer, insira as credenciais apropriadas do Active Directory, conforme descrito em Fazer login no Horizon Universal Console para executar tarefas de gerenciamento no ambiente do Horizon Cloud.
  3. Implante a versão mais recente do dispositivo virtual do Horizon Cloud Connector conforme descrito nas etapas de 1 a 8 de Conectar o Horizon Cloud Service 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 logon com suas credenciais do Customer Connect conforme descrito na etapa 1 acima. Se sua conta de tenant do Horizon Cloud tiver um domínio registrado do Active Directory, a janela de logon do Active Directory será exibida, e você precisará fazer logon com as credenciais adequadas do Active Directory.
  5. Conecte a versão mais recente do appliance do 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 de 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 a versão 1.5 do Horizon Cloud Connector, 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 dispositivo 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 Atualizar.
    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 Depois

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.

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

Para atualizações futuras, se você quiser ativar atualizações automatizadas do dispositivo virtual do Horizon Cloud Connector, em vez de seguir essas etapas manuais, consulte as informações em Configurar atualizações automatizadas do dispositivo virtual Horizon Cloud Connector.