O recurso de reinstalação permite desinstalar o agente existente da VM e reinstalar o software do agente mais recente. O recurso de reinstalação fornece um mecanismo de recuperação para falhas de atualização do agente por instalação forçada e em situações especiais em que você precisa desinstalar e reinstalar o software do agente, conforme descrito nos casos de uso a seguir.

Os seguintes casos de uso ilustram quando você pode realizar uma reinstalação do agente.
Observação: Quando seu ambiente de próxima geração tem uma migração de primeira geração que ainda não foi finalizada, o sistema impede a execução desse procedimento de reinstalação do agente. Depois de clicar em Agente > Reinstalar, será exibida uma mensagem sobre a finalização da migração.

Procedimento

  1. No Horizon Universal Console, navegue até a página Grupos de Pools.
  2. Selecione VMs.
  3. Selecione uma ou mais VMs na lista.
  4. Selecione Agente > Reinstalar.
    A página Reinstalar Agente é aberta. A página solicita informações. Os prompts serão diferentes dependendo de você ter selecionado uma VM ou várias VMs.
    Reinstalar a página do Agente com uma única VM selecionada
    A página Reinstalar Agente com um único agente selecionado. Uma lista parcial dos recursos do agente está visível.
    Reinstalar a página do agente com várias VMs selecionadas
    A página Reinstalar Agente com vários agentes selecionados. Uma lista parcial dos recursos do agente está visível.
  5. Preencha o formulário Reinstalar Agente e clique em Reinstalar.
    Forneça as respostas apropriadas para os prompts a seguir que se aplicarem. Os Argumentos de Linha de Comando se aplicam se você selecionou um único agente ou vários agentes. Todas as outras opções se aplicam somente quando você selecionou vários agentes.
    Opção Descrição
    Ignorar VMs com Usuários Ativos Selecione para ignorar a reinstalação do Horizon Agent para sessões ativas ou desconectadas. Se essa opção não for selecionada, os usuários conectados às VMs quando a reinstalação começar receberão um aviso de 5 minutos e serão desconectados à força.
    Tempo Limite de Trabalho Defina o período de tempo durante o qual deseja que o sistema continue tentando reinstalar os agentes automaticamente. Se você deseja executar reinstalações apenas durante um período específico, pode definir um curto período de tempo, 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 reinstalar com 30 VMs como simultaneidade, calcule o período da seguinte maneira:

    • Número de lotes: 600/30 = 20 lotes
    • Tempo limite do trabalho: 20*60 = 1200 minutos
    Você definiria o tempo limite do trabalho para 1.200 minutos, que é um período muito mais longo do que o normalmente necessário para executar reinstalações.
    Observação: O sistema não tenta reinstalar as VMs que encontram um erro durante o processo de reinstalação.
    Simultaneidade

    Defina um limite para o número de VMs nas quais o sistema tenta reinstalar o 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 reinstalação do agente pode falhar antes que o processo de reinstalação seja interrompido. Definir esse limite impede a ocorrência de falhas em massa.

    Quando o processo de reinstalação é interrompido devido a reinstalações com falha do agente VM, você pode observar um número de VMs com falha maior do que o valor Limite de Falhas 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 reinstalação do agente levará muito tempo, pois reinstalará uma VM por vez. Recomenda-se definir Simultaneidade e Limite de Falhas adequadamente para obter resultados ideais.

    Argumentos de Linha de Comando Na caixa de texto Argumentos de Linha de Comando, adicione quaisquer opções de linha de comando que possam ser relevantes para esta reinstalação.

O que Fazer Depois

O processo de reinstalação do agente é executado em segundo plano. Você pode visualizar o andamento do processo na página Log de Atividades. Consulte Monitorar a atividade do administrador e do usuário final na página de log de atividades

.