Atualizar o software Horizon Agent em VMs de áreas de trabalho dedicadas

As atualizações do Horizon Agent podem incluir novos recursos e correções de bugs. Use esse procedimento para atualizar o software Horizon Agent instalado em suas VMs de área de trabalho dedicada.

Observação: Quando o seu ambiente de próxima geração contiver uma migração de primeira geração que ainda não foi finalizada, o sistema impedirá a execução desse procedimento de agente de atualização, mesmo em grupos de pools que foram criados diretamente no ambiente de próxima geração. Nesse cenário, após clicar em Atualizar Agente, o console exibirá uma mensagem de orientação sobre a necessidade de finalizar a migração.

Para atualizar o software Horizon Agent instalado em suas VMs de área de trabalho dedicada, use o Horizon Universal Console. Você inicia o processo de atualização do agente na página Grupos de Pools, e o foco do processo muda de grupos de pools para pools. Em seguida, você ativa a atualização do agente no nível do de pool, e o sistema atualiza o software Horizon Agent em suas VMs de área de trabalho dedicadas para a versão mais recente disponível.

Cuidado:

Enquanto a operação de atualização do agente está em andamento, você deve garantir que não tenha outras atividades planejadas que possam fazer com que qualquer uma das VMs de área de trabalho do grupo de pools experimente uma operação de alteração de energia. Por exemplo, notifique seus outros administradores para evitar o desligamento manual ou em uma dessas VMs de área de trabalho e garanta que nenhum agendamento de gerenciamento de energia configurado nesse grupo de pools faça com que as áreas de trabalho sejam ligadas ou desligadas enquanto as tarefas do agente de atualização estiverem em execução. Se uma VM de área de trabalho sofrer uma operação de alteração de energia enquanto o sistema está executando as tarefas de atualização do agente na VM, poderão ocorrer resultados inesperados que deixem a VM de área de trabalho em um estado que requer a recuperação manual.

Uma prática recomendada é editar o grupo de pools e remover qualquer agenda de gerenciamento de energia configurada para eliminar as chances de que uma operação de alteração de energia ocorra enquanto as tarefas de atualização do agente estão em execução.

Procedimento

1. No Horizon Universal Console, navegue até a página Grupos de Pools.
   A captura de tela a seguir da página Grupos de Pools ilustra a opção Necessidade de Atualização de Agente.
   
2. (Opcional) Se quiser garantir que a atualização mais recente do agente esteja disponível para o filtro Necessidade de Atualização de Agente, você poderá verificar os grupos de pools em busca de atualizações do agente.
   Observação: Uma verificação de atualizações pode levar alguns minutos, dependendo do número de grupos de pools e pools.
   O Horizon Cloud verifica automaticamente as áreas de trabalho em grupos de pools diariamente para buscar a atualização do agente. O rótulo da ação Verificar se há atualizações exibe a hora da última verificação. Se você quiser verificar os agentes imediatamente em busca de grupos de pools, use a ação Verificar se há atualizações da maneira a seguir.
   1. Selecione Agente > Verificar se Há Atualizações.
      Esse processo é executado em segundo plano. O status é mostrado na página Log de Atividades.
   2. Para exibir o progresso, acesse a página Log de Atividades.
      Consulte Monitorar a atividade do administrador e do usuário final na página de log de atividades para obter informações sobre o Log de Atividades.
3. Para filtrar a lista para que ela consista apenas em grupos de pools que contêm VMs de área de trabalho elegíveis para a atualização do agente, clique em Necessidade de Atualização de Agente.
   Se você verificou se há atualizações na etapa anterior, os dados nesta lista incluirão atualizações descobertas durante a verificação. Caso contrário, a lista consiste em dados computados de verificações anteriores, como as verificações diárias automatizadas ou para eventos específicos.
4. Selecione um ou mais grupos de pools.
5. Selecione Agente > Atualizar Agente.
   Observação: Quando o seu ambiente contém uma migração de primeira geração que ainda não foi finalizada, o console impede a execução do assistente de atualização do agente.
   O assistente para Atualizar Agente é iniciado e apresenta uma página que divide os grupos de pools selecionados em uma lista de pools correspondentes, cada um dos quais contém uma ou mais VMs elegíveis para atualização do agente.
6. Selecione os pools na lista que contêm as VMs que você deseja atualizar e clique em Avançar.
7. Preencha o formulário Detalhes e clique em Salvar.

   Opção	Descrição
   Ignorar VMs com usuários ativos	Selecione para ignorar a atualização do Horizon Agent para sessões ativas ou desconectadas. Se essa opção não estiver selecionada, os usuários conectados às VMs quando a atualização começar receberão um aviso de cinco minutos e, em seguida, serão forçados a fazer logoff.
   Tempo Limite de Trabalho	Defina o período de tempo durante o qual você deseja que o sistema continue tentando atualizar automaticamente os agentes. Se você quiser executar atualizações somente durante um período específico, poderá definir um curto período, mesmo se selecionar vários modelos e VMs. Um lote de VMs pode levar de 20 a 60 minutos, dependendo do estado da VM e de qualquer outro tempo de espera e novas tentativas em andamento. Por exemplo, se você tiver mais de 600 VMs para atualizar com 30 VMs como simultaneidade, calculará o período da seguinte maneira: Número de lotes: 600/30 = 20 lotes Tempo limite do trabalho: 20*60 = 1200 minutos Você define o tempo limite do trabalho como 1200 minutos, período muito mais longo do que o normalmente necessário para executar atualizações. Observação: O sistema não atualiza novamente as VMs que encontram um erro durante o processo de atualização.
   Simultaneidade	Defina um limite para o número de VMs em que o sistema tenta a atualização do agente simultaneamente. Essa configuração funciona em paralelo com a configuração Limite de Falhas. O ideal é manter a configuração Simultaneidade menor ou igual à configuração Limite de Falhas.
   Limite de Falhas	O número de VMs para as quais a atualização do agente tem permissão para falhar antes que o processo de atualização seja interrompido. Definir esse limite impede a ocorrência de falhas em massa. Quando o processo de atualização é interrompido devido a atualizações com falha do agente de VM, você pode observar um número de VMs com falha que é maior que o valor de Limite de Falha definido. Se você precisar garantir que haverá menos falhas do que o número especificado para a configuração Limite de Falhas, defina o valor de Simultaneidade como 1. Isso também significa que o processo de atualização do agente levará muito tempo, pois ele atualizará uma VM de cada vez. Recomenda-se definir Simultaneidade e Limite de Falhas adequadamente para obter resultados ideais.
   Argumentos de Linha de Comando	Na caixa Argumentos de Linha de Comando, adicione quaisquer opções de linha de comando que possam ser relevantes para essa atualização.

O que Fazer Depois

O processo de Atualização do Agente é executado em segundo plano, e o status é mostrado na página Log de Atividades. Acesse a página Log de Atividades para exibir o progresso. Para obter informações sobre o Log de Atividades, consulte Monitoramento das atividades do administrador e do usuário final na página Log de Atividades.