Mettre à jour le logiciel Horizon Agent sur les VM de postes de travail dédiés

Les mises à jour d'Horizon Agent peuvent inclure de nouvelles fonctionnalités et de nouveaux correctifs de bogues. Utilisez cette procédure pour mettre à jour les logiciels Horizon Agent installés sur vos VM de poste de travail dédié.

Note : Lorsque votre environnement de nouvelle génération contient 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 mise à jour de l'agent, même sur les groupes de pools qui ont été créés directement dans l'environnement de nouvelle génération. Dans ce scénario, lorsque vous cliquez sur Mettre à jour l'agent, la console affiche un message d'instruction sur la nécessité de finaliser la migration.

Pour mettre à jour les logiciels Horizon Agent installés sur vos VM de poste de travail dédié, utilisez Horizon Universal Console. Démarrez le processus de mise à jour de l'agent sur la page Groupes de pools et le focus du processus passe des groupes de pools aux pools. Activez ensuite la mise à jour de l'agent au niveau du pool pour que le système mette à jour les logiciels Horizon Agent sur vos VM de poste de travail dédié vers la dernière version disponible.

Attention :

Lorsque l'opération de mise à jour de l'agent est en cours, vous devez vous assurer qu'aucune autre activité planifiée ne peut entraîner d'opération de changement d'alimentation dans les VM de poste de travail du groupe de pools. Informez, par exemple, vos autres administrateurs qu'ils évitent de mettre manuellement hors ou sous tension l'une de ces VM de poste de travail. Vérifiez ensuite que les planifications de gestion de l'alimentation configurées dans ce groupe de pools n'entraînent pas la mise sous ou hors tension des postes de travail lors de l'exécution des tâches de mise à jour de l'agent. En cas d'opération de changement d'alimentation sur une machine virtuelle de poste de travail tandis que le système exécute ses tâches de mise à jour de l'agent sur la VM, des résultats imprévus peuvent se produire et laisser cette VM de poste de travail dans un état qui nécessite la récupération manuelle.

Il est recommandé de modifier le groupe de pools et de supprimer les planifications configurées de gestion de l'alimentation pour éliminer le risque d'opération de changement d'alimentation lors de l'exécution des tâches de mise à jour de l'agent.

Procédure

1. Dans Horizon Universal Console, accédez à la page Groupes de pools.
   La capture d'écran suivante de la page Groupes de pools illustre l'option Mise à jour de l'agent requise.
   
2. (Facultatif) Pour vérifier que la dernière mise à jour de l'agent est disponible pour le filtre Mise à jour de l'agent requise, vous pouvez rechercher les mises à jour de l'agent pour les groupes de pools.
   Note : Une recherche des mises à jour peut prendre quelques minutes, selon le nombre de groupes de pools et de pools.
   Horizon Cloud recherche automatiquement les mises à jour de l'agent tous les jours pour les postes de travail dans les groupes de pools. L'étiquette de l'action Rechercher les mises à jour affiche l'heure de la dernière analyse. Pour rechercher immédiatement les groupes de pools dans les agents, utilisez l'action Rechercher les mises à jour comme suit.
   1. Sélectionnez Agent > Rechercher les mises à jour.
      Ce processus s'exécute en arrière-plan. L'état s'affiche sur la page Journal d'activité.
   2. Pour afficher la progression, accédez à la page Journal d'activité.
      Pour plus d'informations sur le 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é.
3. Pour filtrer la liste afin qu'elle se compose uniquement de groupes de pools qui contiennent des VM de poste de travail remplissant les conditions de mise à jour de l'agent, cliquez sur l'option Mise à jour de l'agent requise.
   Si vous avez recherché les mises à jour à l'étape précédente, les données de cette liste incluent les mises à jour détectées lors de l'analyse. Sinon, la liste se compose de données calculées à partir d'analyses précédentes, telles que les analyses quotidiennes automatiques ou pour des événements spécifiques.
4. Sélectionnez un ou plusieurs groupes de pools.
5. Sélectionnez Agent > Mettre à jour l'agent.
   Note : Lorsque votre environnement contient une migration de première génération qui n'est pas encore finalisée, la console empêche l'exécution de l'assistant de mise à jour de l'agent.
   L'assistant Mettre à jour l'agent démarre et présente une page qui fractionne les groupes de pools sélectionnés en une liste de pools correspondants, chacun d'eux contenant une ou plusieurs VM remplissant les conditions de mise à jour de l'agent.
6. Sélectionnez les pools dans la liste contenant les VM à mettre à jour, puis cliquez sur Suivant.
7. Remplissez le formulaire Détails et cliquez sur Enregistrer.

   Option	Description
   Ignorer les VM ayant des utilisateurs actifs	Sélectionnez cette option pour ignorer la mise à jour 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 mise à jour 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 à mettre à jour automatiquement les agents. Pour exécuter des mises à jour 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 à mettre à jour 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 mises à jour. Note : Le système ne tente pas de mettre à jour les VM qui rencontrent une erreur pendant le processus de mise à jour.
   Simultanéité	Définissez une limite au nombre de VM sur lesquelles le système tente de mettre à jour 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 lesquelles la mise à jour de l'agent est autorisée à échouer avant l'arrêt du processus de mise à jour. La configuration de ce seuil évite les échecs en masse. Lorsque le processus de mise à jour s'arrête en raison de l'échec des mises à jour 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 mise à jour de l'agent prendra longtemps, car il mettra à jour 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 mise à jour.

Que faire ensuite

Le processus de mise à jour de l'agent s'exécute en arrière-plan et l'état s'affiche sur la page Journal d'activité. Accédez à la page Journal d'activité pour afficher la progression. Pour plus d'informations sur le 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é.