Mises à niveau des VDA (Technical Preview)
Introduction
Auparavant, la mise à niveau des VDA nécessitait une intervention manuelle complète. La version 2503 simplifie les mises à niveau des VDA pour les déploiements DaaS en introduisant l’agent de mise à niveau de VDA. Les mises à niveau à partir de la version 2503 peuvent être effectuées ultérieurement directement à partir d’un chemin de fichier partagé ou local.
L’agent de mise à niveau de VDA ctxvua est chargé de communiquer avec le service de mise à niveau de VDA et d’exécuter les fonctions suivantes :
- Vérifications planifiées : l’agent de mise à niveau de VDA interroge le service de mise à niveau de VDA pour obtenir des informations de mise à niveau planifiée toutes les 15 minutes.
- Mises à niveau automatisées : dès réception des instructions de mise à niveau, l’agent de mise à niveau de VDA met automatiquement à niveau le VDA.
- Rapport d’état : l’agent de mise à niveau de VDA signale le résultat de la mise à niveau (succès ou échec) au service de mise à niveau de VDA.
Pour en savoir plus sur le service de mise à niveau du VDA, consultez la fiche technique : Service de mise à niveau du VDA Citrix. Vous y trouverez un aperçu du service, des informations détaillées sur son fonctionnement et d’autres ressources utiles.
Considérations
-
Les VDA Linux sont mis à niveau à l’aide de commandes de gestion de paquets sous-jacentes (comme rpm ou apt), reflétant le processus de mise à niveau manuelle, les fichiers de configuration sont automatiquement gérés pendant la mise à niveau à partir de la ligne de commandes.
-
Contrairement à Windows, Linux VDA inclut un agent de mise à niveau de VDA intégré. Cela simplifie le processus de mise à niveau puisque l’agent est déjà présent. La version de l’agent de mise à niveau de VDA est liée à la version de VDA.
-
Par défaut, l’agent de mise à niveau de VDA est désactivé. Pour activer l’agent, exécutez les commandes suivantes :
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\UpdateServices\UpdateAgent" -t "REG_DWORD" -v "fEnabled" -d "0x00000001" --force systemctl start ctxvua.service <!--NeedCopy--> -
Le service d’agent de mise à niveau de VDA (ctxvua) est désactivé par défaut. Vous pouvez utiliser systemctl pour activer et démarrer ce service.
-
Nous vous recommandons de tester rigoureusement les mises à niveau des VDA avant de passer en production.
-
Contrairement à Windows, les mises à niveau de Linux VDA ne sont prises en charge qu’à partir d’un chemin de fichier. Cela signifie que vous ne pouvez pas utiliser directement les URL Azure CDN ou d’autres référentiels en ligne. Vous devez gérer vous-même les packages VDA. Ceci s’applique aux mises à niveau de versions majeures et mineures.
-
Ignorez « Dernière version du VDA » et « État de mise à niveau » dans le service de mise à niveau de VDA. Seul l’« État de mise à niveau de VDA » est pertinent pour Linux.
-
Le chemin d’accès au fichier du package VDA peut être local sur la machine du VDA ou un emplacement partagé (par exemple, un partage réseau monté sur le VDA). Le système n’est pas conçu pour télécharger le package automatiquement. Vous devez fournir le fichier du package complet.
-
Spécifiez le chemin au format de chemin UNC Windows (commençant par \\) pour réussir la validation du chemin lors de l’utilisation de Studio ou de Citrix DaaS Remote PowerShell SDK. Par exemple, /mnt/pkg\/<nom-du-package> doit être saisi sous la forme \\mnt\pkg\<nom-du-package>.
-
La distinction entre les VDA « serveur » et « poste de travail » ne s’applique pas à Linux. Vous pouvez utiliser l’une ou l’autre option dans Studio ou PowerShell sans affecter la mise à niveau.
-
La mise à niveau vers une version antérieure des VDA n’est pas prise en charge.
Prérequis
- Plan de contrôle : Citrix DaaS
-
Version de VDA : 2503 ou ultérieure
Remarque
Nous vous recommandons d’utiliser la dernière version CR de VDA.
- Les VDA doivent avoir l’agent de mise à niveau de VDA installé et le service doit être en cours d’exécution.
- Vous êtes autorisé à mettre à niveau des VDA.
- La mise à niveau de VDA est configurée avec la piste CR ou LTSR appropriée dans Studio.
- Les VDA ne sont pas utilisés. (Les utilisateurs doivent s’en déconnecter.)
- Les VDA ne sont pas en mode de maintenance. (Un VDA peut être mis en mode de maintenance par un administrateur. Un VDA peut également être automatiquement mis en mode de maintenance s’il a dépassé le nombre maximal de tentatives d’enregistrement autorisées.)
- Les VDA doivent appartenir à un groupe de mise à disposition et être enregistrés auprès de DaaS.
- Le VDA de destination prend en charge le système d’exploitation du VDA actuel.
Mettre à niveau les VDA à l’aide de Studio
Workflow général
Workflow général de mise à niveau des VDA à l’aide de Studio :
-
Activez la mise à niveau de VDA pour un catalogue.
- Vous pouvez activer la mise à niveau de VDA lors de la création d’un catalogue.
- Vous pouvez activer la mise à niveau de VDA lors de la modification d’un catalogue.
-
Mettre à niveau les VDA par catalogue. Les mises à niveau de VDA par machine ne sont actuellement pas disponibles. Pour plus d’informations, consultez Configurer la mise à niveau automatique pour les VDA.
Remarque
Lors de la planification des mises à niveau de VDA pour un catalogue, toutes les machines du catalogue sont incluses dans la portée de la mise à niveau. Nous vous recommandons donc de sauvegarder ces machines avant de lancer la mise à niveau.
-
Le processus de mise à niveau de VDA ne prend pas en charge la mise à niveau de composants supplémentaires ni l’utilisation de fonctionnalités telles que la restauration. Ignorez ces deux étapes.
-
Configurez les options de planification, y compris l’heure de mise à niveau et le seuil d’échec de la mise à niveau. Le seuil d’échec détermine probablement le nombre de mises à niveau échouées tolérées avant que le processus ne soit arrêté ou que des alertes ne soient déclenchées.
-
Sélectionnez « Utiliser le partage de fichiers local » pour l’emplacement du programme d’installation de VDA. Fournissez le chemin au format UNC Windows (par exemple, \\server\share\path).
-
L’option de session « Forcer la déconnexion » contrôle la manière dont les sessions utilisateur sont gérées pendant les mises à niveau de VDA. Alors que l’interface utilisateur de Studio permet uniquement de fermer les sessions déconnectées, PowerShell peut fermer toutes les sessions (connectées et déconnectées). La fermeture de session n’est pas immédiate. Le service de mise à niveau de VDA lance la déconnexion après que l’agent de mise à niveau de VDA tente d’interroger le calendrier de mise à niveau et trouve des sessions déconnectées. L’agent attend ensuite 15 minutes avant de tenter à nouveau la requête.
Mettre à niveau les VDA à l’aide de PowerShell
Vous pouvez configurer les mises à niveau de VDA à l’aide de Remote PowerShell SDK sous Windows. Pour plus d’informations sur Remote PowerShell SDK, consultez Citrix DaaS Remote PowerShell SDK.
Les applets de commande PowerShell sont les suivantes :
-
Get-VusCatalog
Utilisez cette applet de commande pour obtenir les détails d’un catalogue, tels que Name, Uid, Uuid, UpgradeState (Available, UpToDate, Scheduled, Unknown), Upgrade scheduledet StateId (état de Upgrade scheduled).
-
Get-VusMachine
Utilisez cette applet de commande pour obtenir les détails d’une machine, tels que MachineName, Uid, Uuid, UpgradeState (Available, UpToDate, Scheduled, Unknown) et StateId (état de Upgrade scheduled).
-
Get-VusComponentVersion
Utilisez cette applet de commande pour vérifier si les VDA ont signalé les versions des composants. Utilisez le MachineId pour filtrer les VDA. MachineId est l’UUID de Get-BrokerMachine.
-
New-VusMachineUpgrade
Utilisez cette applet de commande pour configurer les mises à niveau du VDA au niveau des machines.
-
New-VusCatalogSchedule
Utilisez cette applet de commande pour planifier les mises à niveau des VDA au niveau du catalogue de machines.
Exemple
Get-BrokerMachine -DNSName 'u22-test*'
New-VusCatalogSchedule -CatalogName "test-catalog" -UpgradeNow -DurationInHours 2 -LogoffOption ActiveAndDisconnectedSessions -VdaServerPackageUri "\\root\xendesktopvda_24.11.0.1-1.ubuntu22.04_amd64.deb"
Get-VusComponent -CatalogName 'test-catalog'
Get-VusCatalog -Name 'test-catalog'
<!--NeedCopy-->
Dépannage
Le cœur du processus de mise à niveau s’articule autour du service VDA Upgrade Agent (ctxvua). Il agit comme intermédiaire, communiquant avec le service de mise à niveau de VDA et exécutant le script /opt/Citrix/VDA/sbin/update_helper.sh pour les opérations liées au système d’exploitation. Pendant la mise à niveau, les informations sur le processus sont stockées dans le registre.
Registre
| Utilisez la commande **/opt/Citrix/VDA/bin/ctxreg dump | grep -i UpdateAgent** pour examiner les paramètres de registre liés à VDA Upgrade Agent. Cela peut révéler des problèmes de configuration ou des problèmes avec le processus de mise à niveau lui-même. |
- Vérifier la configuration : le fichier de configuration du service ctxvua se trouve dans /etc/xdl/updateagent.conf. L’examen de ce fichier peut aider à identifier les erreurs de configuration.
Journaux
Les fichiers journaux suivants sont essentiels pour le dépannage :
-
/var/log/xdl/vua.log : fichier journal pour le service ctxvua. Il s’agit du journal principal permettant de vérifier les problèmes liés au fonctionnement de l’agent de mise à niveau. Le fichier de configuration du service ctxvua se trouve dans /etc/xdl/updateagent.conf. L’examen de ce fichier peut aider à identifier les erreurs de configuration.
-
/var/log/xdl/update_helper.log : fichier journal pour le script update_helper.sh. Ce journal est essentiel pour diagnostiquer les problèmes liés aux tâches au niveau du système d’exploitation pendant la mise à niveau.
Problèmes courants
Cette section aborde les problèmes courants rencontrés lors des mises à niveau de VDA, en se concentrant spécifiquement sur les options désactivées dans Studio et l’état « Mise à niveau inconnue ».
Problème courant 1 : options de mise à niveau désactivées
Symptôme : les options « Définir le type de mise à niveau » et « Mettre à niveau les VDA » sont désactivées (grisées) dans Studio pour un catalogue donné.
Solution : vérifiez si le service de mise à niveau de VDA est pris en charge pour le type de catalogue que vous utilisez. Si ce n’est pas le cas, vous ne pouvez pas utiliser ces fonctionnalités de mise à niveau automatisées et devez gérer les mises à niveau manuellement.
Problème courant 2 : état « Mise à niveau inconnue »
Symptôme : après avoir activé le service de mise à niveau de VDA pour un catalogue de machines, l’« État de mise à niveau » reste « Inconnu » au lieu de passer à « Disponible » ou « À jour » comme prévu. « Mise à niveau inconnue » est un état transitoire. Il devrait éventuellement être mis à jour vers « Disponible » ou « À jour ».
Étapes de dépannage pour « Mise à niveau inconnue » :
-
Vérifiez que VDA Upgrade Agent signale les versions.
-
Étape 1a : obtenez l’UUID de la machine :
Get-BrokerMachine -DNSName '<hostname>' <!--NeedCopy--> -
Étape 1b : vérifiez la version du composant signalée par l’agent :
Get-VusComponentVersion -MachineId "<UUID>" <!--NeedCopy-->Si la commande Get-VusComponentVersion ne renvoie rien, cela signifie que le VDA Upgrade Agent n’a pas signalé sa version. Cela peut indiquer que le VDA est « enregistré strictement » (vérifiez à la fois le catalogue de la machine et les paramètres du groupe de mise à disposition). Cela indique également que le VDA Upgrade Agent n’est peut-être pas installé ou en cours d’exécution sur le VDA cible.
-
-
Vérifiez la synchronisation du VDA Upgrade Service.
Étape 2a : vérifiez si le VDA Upgrade Service a synchronisé la machine à partir de la base de données du broker :
``` Get-VusEntityUnit -EntityUUID "" <!--NeedCopy--> ```Remplacez
""par l’EntityUUID réel s’il est connu, ou lancez l’exécution sans pour tout obtenir. Si vous constatez que ce champ est vide, cela peut indiquer que la machine n’a pas été synchronisée avec le serveur du VDA Upgrade Service.Étape 2b : si la machine n’est pas synchronisée, laissez un certain temps au VDA Upgrade Service pour se synchroniser. Ensuite, confirmez que le « Type de mise à niveau » a été défini.