La fonctionnalité de réinstallation permet de désinstaller l'agent existant de la VM et de réinstaller le dernier logiciel agent. La fonctionnalité de réinstallation fournit un mécanisme de récupération pour les échecs de mise à jour de l'agent par l'installation forcée et dans des situations spéciales où vous devez désinstaller et réinstaller le logiciel agent, comme décrit dans les cas d'utilisation suivants.

Ces derniers illustrent dans quels cas vous pouvez effectuer une réinstallation de l'agent.
Note : Lorsque votre environnement de nouvelle génération dispose d'une migration de première génération qui n'est pas encore finalisée, le système empêche l'exécution de cette procédure de réinstallation de l'agent. Après avoir cliqué sur Agent > Réinstaller, un message s'affiche sur la finalisation de la migration.

Procédure

  1. Dans Horizon Universal Console, accédez à la page Groupes de pools.
  2. Sélectionnez des VM.
  3. Sélectionnez une ou plusieurs machines virtuelles dans la liste.
  4. Sélectionnez Agent > Réinstaller.
    La page Réinstaller l'agent s'ouvre. Cette page vous invite à fournir des informations. Les invites varient selon que vous avez sélectionné une ou plusieurs VM.
    Réinstaller la page Agent avec une seule VM sélectionnée
    Page Réinstaller l'agent avec un seul agent sélectionné. Une liste partielle des fonctionnalités de l'agent est visible.
    Réinstaller la page Agent avec plusieurs VM sélectionnées
    Page Réinstaller l'agent avec plusieurs agents sélectionnés. Une liste partielle des fonctionnalités de l'agent est visible.
  5. Remplissez le formulaire Réinstaller l'agent et cliquez sur Réinstaller.
    Fournissez les réponses appropriées aux invites suivantes qui s'appliquent. L'option Arguments de ligne de commande s'applique si vous avez sélectionné un ou plusieurs agents. Toutes les autres options s'appliquent uniquement lorsque vous avez sélectionné plusieurs agents.
    Option Description
    Ignorer les VM ayant des utilisateurs actifs Sélectionnez cette option pour ignorer la réinstallation d'Horizon Agent pour les sessions actives ou déconnectées. Si cette option n'est pas sélectionnée, les utilisateurs connectés aux VM lorsque la réinstallation commence recevront un avertissement au bout de 5 minutes, puis seront déconnectés de force.
    Délai d'expiration de la tâche Définissez la période pendant laquelle le système doit continuer à réinstaller automatiquement les agents. Pour exécuter des réinstallations uniquement pendant une période spécifique, vous pouvez définir une courte période, même si vous sélectionnez plusieurs modèles et VM. Un lot de VM peut prendre entre 20 et 60 minutes en fonction de l'état des VM et de tout autre délai d'attente et de nouvelles tentatives en cours.

    Par exemple, si vous disposez de plus de 600 VM à réinstaller avec 30 VM en simultanéité, vous devez calculer la période comme suit :

    • Nombre de lots : 600/30 = 20 lots
    • Délai d'expiration de la tâche : 20 × 60 = 1 200 minutes
    Vous devez définir le délai d'expiration de la tâche sur 1 200 minutes, ce qui constitue une période beaucoup plus longue que celle généralement requise pour l'exécution des réinstallations.
    Note : Le système ne tente pas de réinstaller les VM qui rencontrent une erreur pendant le processus de réinstallation.
    Simultanéité

    Définissez une limite au nombre de VM sur lesquelles le système tente de réinstaller l'agent simultanément.

    Ce paramètre fonctionne en parallèle avec le paramètre Seuil d'échec. Idéalement, conservez le paramètre Simultanéité sur une valeur inférieure ou égale au paramètre Seuil d'échec.

    Seuil d'échec

    Nombre de VM pour lequel la réinstallation de l'agent est autorisée à échouer avant l'arrêt du processus de réinstallation. La configuration de ce seuil évite les échecs en masse.

    Lorsque le processus de réinstallation s'arrête en raison de l'échec des réinstallations de l'agent de VM, vous pouvez observer un nombre de VM ayant échoué supérieur à la valeur Seuil d'échec. Si vous devez vous assurer qu'il y a moins d'échecs que le nombre spécifié pour le paramètre Seuil d'échec, définissez la valeur Simultanéité sur 1. Cela signifie également que le processus de réinstallation de l'agent prendra longtemps, car il réinstallera une seule VM à la fois. Il est recommandé de définir Simultanéité et Seuil d'échec de manière appropriée pour obtenir des résultats optimaux.

    Arguments de ligne de commande Dans la zone de texte Arguments de ligne de commande, ajoutez toutes les options de ligne de commande qui peuvent être appropriées à cette réinstallation.

Que faire ensuite

Le processus de réinstallation de l'agent s'exécute en arrière-plan. Vous pouvez afficher la progression du processus sur la page Journal d'activité. Reportez-vous à la section Surveillance de l'activité de l'administrateur et de l'utilisateur final sur la page Journal d'activité

.