La función de reinstalación permite desinstalar el agente existente de la máquina virtual y volver a instalar el software del agente más reciente. La función de reinstalación proporciona un mecanismo de recuperación para los errores de actualización del agente por instalación forzada y en situaciones especiales en las que es necesario desinstalar y volver a instalar el software del agente, como se describe en los siguientes casos prácticos.

Los siguientes casos prácticos ilustran cuándo se puede realizar la reinstalación de un agente.
Nota: Cuando el entorno de next-gen tiene una migración de first-gen que aún no ha finalizado, el sistema impide ejecutar este procedimiento de reinstalar el agente. Después de hacer clic en Agente > Reinstalar, se muestra un mensaje sobre la finalización de la migración.

Procedimiento

  1. En Horizon Universal Console, desplácese a la página Grupos de grupos.
  2. Seleccione Máquinas virtuales.
  3. Seleccione una o varias máquinas virtuales de la lista.
  4. Seleccione Agente > Reinstalar.
    Se abrirá la página Reinstalar agente. La página le solicitará información. Los mensajes varían en función de si seleccionó una o varias máquinas virtuales.
    Reinstalar la página del agente con una sola máquina virtual seleccionada
    La página Reinstalar agente con un solo agente seleccionado. Puede ver una lista parcial de las funciones del agente.
    Reinstalar la página del agente con varias máquinas virtuales seleccionadas
    La página Reinstalar agente con varios agentes seleccionados. Puede ver una lista parcial de las funciones del agente.
  5. Complete el formulario Reinstalar agente y haga clic en Reinstalar.
    Proporcione las respuestas adecuadas a las siguientes indicaciones que correspondan. Argumentos de línea de comando se aplica tanto si seleccionó un solo agente como si se seleccionaron varios agentes. Todas las demás opciones solo se aplican cuando se seleccionan varios agentes.
    Opción Descripción
    Omitir máquinas virtuales con usuarios activos Seleccione esta opción para omitir la reinstalación de Horizon Agent para sesiones activas o desconectadas. Si esta opción no está seleccionada, los usuarios que hayan iniciado sesión en las máquinas virtuales cuando comience la reinstalación recibirán una advertencia de 5 minutos y, a continuación, se cerrará la sesión de forma forzada.
    Tiempo de espera de la tarea Establezca el período durante el cual desea que el sistema continúe intentando reinstalar los agentes automáticamente. Si desea ejecutar reinstalaciones solo durante un período específico, puede establecer un breve período de tiempo incluso si selecciona varias plantillas y máquinas virtuales. Un lote de máquinas virtuales puede tardar entre 20 y 60 minutos, según el estado de la máquina virtual y cualquier otro tiempo de espera y reintentos en proceso.

    Por ejemplo, si tiene más de 600 máquinas virtuales para reinstalar con 30 máquinas virtuales como simultaneidad, calculará el período de la siguiente manera:

    • Número de lotes: 600/30 = 20 lotes
    • Tiempo de espera del trabajo: 20*60 = 1200 minutos
    El tiempo de espera del trabajo se establece en 1200 minutos, que es un período mucho más largo del que normalmente se requiere para ejecutar reinstalaciones.
    Nota: El sistema no vuelve a intentar reinstalar las máquinas virtuales que detectan un error durante el proceso de reinstalación.
    Simultaneidad

    Establezca un límite para el número de máquinas virtuales en las que el sistema intenta reinstalar el agente de forma simultánea.

    Esta opción funciona en paralelo con la opción Umbral de errores. Lo ideal es mantener la configuración de Concurrencia en un valor inferior o igual a la configuración de Umbral de errores.

    Umbral de errores

    El número de máquinas virtuales para las que se puede producir un error en la reinstalación del agente antes de que se detenga el proceso de reinstalación. El ajuste de este umbral evita que se produzcan errores masivos.

    Cuando el proceso de reinstalación se detiene debido a errores en agente las reinstalaciones de la máquina virtual, es posible que aparezca un número de máquinas virtuales con errores que superan el valor establecido de Umbral de errores. Si necesita asegurarse de que se producirán menos errores que el número especificado para la opción Umbral de errores, establezca el valor de Concurrencia en 1. Esto también significa que el proceso de reinstalación del agente tardará mucho tiempo, porque se reinstalará una máquina virtual a la vez. Se recomienda establecer Concurrencia y Umbral de errores correctamente para obtener resultados óptimos.

    Argumentos de la línea de comandos En el cuadro de texto Argumentos de línea de comandos, agregue las opciones de línea de comandos que puedan ser relevantes para esta reinstalación.

Qué hacer a continuación

El proceso de reinstalación del agente se ejecuta en segundo plano. Puede ver el progreso del proceso en la página Registro de actividades. Consulte Supervisar la actividad del administrador y del usuario final desde la página Registro de actividades

.