Outils et utilitaires
Utilitaire permettant d’interroger les données de session
Nous fournissons un utilitaire (ctxsdcutil) permettant d’interroger les données de session sur chaque Linux VDA. Pour interroger les données suivantes de toutes les sessions ou d’une session spécifique hébergée sur un VDA, exécutez la commande /opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c]. L’argument [-c] signifie que les données sont interrogées toutes les secondes.
-
Bande passante de session - entrée
-
Bande passante de session - sortie
-
Vitesse de ligne de session en sortie
-
Latence - dernière enregistrée
-
Durée des boucles
-
Bande passante de sortie de ThinWire
-
Bande passante de sortie de l’audio
-
Bande passante de sortie de l’imprimante
-
Bande passante d’entrée du lecteur
-
Bande passante de sortie du lecteur
Le script Bash xdlcollect
Le script Bash xdlcollect utilisé pour collecter les journaux est intégré dans le logiciel Linux VDA et se trouve dans /opt/Citrix/VDA/bin. Après avoir installé Linux VDA, vous pouvez exécuter la commande bash /opt/Citrix/VDA/bin/xdlcollect.sh pour collecter les journaux. Une fois la collecte des journaux terminée, un fichier journal compressé est généré dans le même dossier que le script. Le script Bash xdlcollect peut vous demander s’il faut charger le fichier journal compressé sur Citrix Insight Services (CIS). Si vous acceptez, xdlcollect renvoie upload_ID une fois le téléchargement terminé. Le téléchargement ne supprime pas le fichier journal compressé de votre machine locale. Les autres utilisateurs peuvent utiliser upload_ID pour accéder au fichier journal dans CIS.
XDPing
L’outil XDPing pour Linux est une application de ligne de commande. Il automatise le processus de vérification des problèmes de configuration courants dans un environnement Linux VDA.
Installer l’outil XDPing Linux
L’exécution de ctxsetup.sh n’installe pas XDPing. Pour installer XDPing, exécutez sudo /opt/Citrix/VDA/bin/xdping.
Cette commande crée également un environnement virtuel Python3 requis pour XDPing. Si cette commande ne parvient pas à créer un environnement virtuel Python3, créez-le manuellement en suivant les instructions de la section Créer un environnement virtuel Python3.
Pour résoudre les erreurs de connexion SSL que vous pouvez rencontrer lors de l’utilisation de l’outil pip, envisagez d’ajouter les hôtes approuvés suivants au fichier /etc/pip.conf :
[global]
trusted-host =
pypi.org
files.pythonhosted.org
Tâches pouvant être effectuées avec XDPing
L’outil XDPing est fourni avec l’exécutable unique nommé xdping qui est exécuté à partir de l’interface de commande.
Le tableau suivant décrit les différentes tâches qui peuvent être effectuées avec les commandes XDPing correspondantes :
| Tâche | Commande XDPing | Remarques |
|---|---|---|
| Pour afficher les options de la ligne de commande | sudo /opt/Citrix/VDA/bin/xdping -h | S/O |
| Pour exécuter la suite complète de tests | sudo /opt/Citrix/VDA/bin/xdping (exécutez XDPing sans aucune option de ligne de commande) | L’outil Linux XDPing effectue plus de 150 tests individuels sur le système. Pour plus d’informations, consultez la section Tests individuels plus loin dans cet article. |
| Pour vérifier l’état d’enregistrement d’un VDA | sudo /opt/Citrix/VDA/bin/xdping -a | Pour plus d’informations, consultez la section Aperçu des vérifications de l’état d’enregistrement plus loin dans cet article. |
| Pour sauvegarder les données clés d’un VDA | sudo /opt/Citrix/VDA/bin/xdping -b | Pour plus d’informations, consultez la section Sauvegarder et comparer les données VDA plus loin dans cet article. |
| Pour comparer les deux dernières copies des données de sauvegarde du VDA | sudo /opt/Citrix/VDA/bin/xdping -diff | Pour plus d’informations, consultez la section Sauvegarder et comparer les données VDA plus loin dans cet article. |
| Pour comparer deux copies spécifiques des données de sauvegarde du VDA | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
Pour plus d’informations, consultez la section Sauvegarder et comparer les données VDA plus loin dans cet article. |
| Pour vérifier l’environnement avant d’installer le package du VDA Linux | sudo /opt/Citrix/VDA/bin/xdping –preflight | S/O |
| Pour exécuter uniquement des catégories de test spécifiques, par exemple les tests liés à l’heure et à Kerberos | sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos | S/O |
| Pour analyser un Delivery Controller spécifique | **sudo /opt/Citrix/VDA/bin/xdping -d |
S/O |
Tests individuels
L’outil XDPing Linux effectue plus de 150 tests individuels sur le système, qui sont généralement classés comme suit :
Remarque :
L’outil Linux XDPing n’effectue pas de tests SQLite.
- Vérifier si la configuration système du VDA Linux est respectée
- Identifier et afficher les informations de la machine, y compris les distributions Linux
- Vérifier la compatibilité du noyau Linux
- Vérifier les problèmes de distribution Linux connus qui peuvent avoir un impact sur le fonctionnement du VDA Linux
- Vérifier le mode de sécurité Security-Enhanced Linux (SELinux) et sa compatibilité
- Identifier les interfaces réseau et vérifier les paramètres réseau
- Vérifier le partitionnement du stockage et l’espace disque disponible
- Vérifier la configuration du nom d’hôte et du nom de domaine de la machine
- Vérifier la configuration DNS et effectuer des tests de recherche
- Identifier les hyperviseurs sous-jacents et vérifier la configuration de la machine virtuelle. Prise en charge de :
- Citrix Hypervisor
- Microsoft HyperV
- VMware vSphere
- Vérifier les paramètres d’heure et vérifier si la synchronisation de l’heure réseau est opérationnelle
- Vérifier si le service PostgreSQL est correctement configuré et opérationnel
- Vérifier si le pare-feu est activé et si les ports requis sont ouverts
- Vérifier la configuration de Kerberos et effectuer des tests d’authentification
- Vérifier l’environnement de recherche LDAP pour Group Policy Engine Service
- Vérifier si l’intégration Active Directory est correctement configurée et que la machine actuelle est jointe au domaine. Prise en charge de :
- Samba Winbind
- Dell Quest Authentication Services
- Centrify DirectControl
- SSSD
- Vérifier l’intégrité de l’objet ordinateur Linux dans Active Directory
- Vérifier la configuration du module d’authentification enfichable (PAM)
- Vérifier le modèle de l’image mémoire
- Vérifier si les packages requis par le VDA Linux sont installés
- Identifier le package du VDA Linux et vérifier l’intégrité de l’installation
- Vérifier l’intégrité de la base de données de registre PostgreSQL
- Vérifier si les services du VDA Linux sont correctement configurés et opérationnels
- Vérifier l’intégrité de la configuration VDA et HDX
- Analyser la configuration de chaque Delivery Controller pour vérifier que le Broker Service est accessible, opérationnel et réactif
- Vérifier si la machine est enregistrée auprès de la batterie du Delivery Controller
- Vérifier l’état de chaque session HDX active ou déconnectée
- Analyser les fichiers journaux pour les erreurs et avertissements liés au VDA Linux
- Vérifier si la version de Xorg est adaptée
- Vérifier si les dépendances requises sont installées
Exemple de sortie
Voici un exemple de sortie lors de l’exécution du test Kerberos :
Aperçu des vérifications de l’état d’enregistrement d’un VDA
L’outil Linux XDPing fournit également un module d’analyse pour vous aider à vérifier et à analyser l’état d’enregistrement de votre VDA. Pour obtenir un aperçu des vérifications de l’état d’enregistrement, consultez la capture d’écran suivante :
Sauvegarder et comparer les données VDA
À partir de Linux VDA 2305, l’outil XDPing introduit un module de sauvegarde VDA. Ce module vous permet de sauvegarder les données clés d’un VDA à tout moment, telles que la configuration, la base de données et les données d’autorisation binaires. Vous pouvez sauvegarder les données clés d’un VDA lorsqu’il fonctionne correctement. En cas de défaillance ultérieure du VDA, sauvegardez une autre copie des données et comparez les deux copies pour faciliter le dépannage. Le tableau suivant décrit la sauvegarde des données VDA et la comparaison avec les commandes XDPing correspondantes :
| Tâche | Commande XDPing | Remarques |
|---|---|---|
| Pour sauvegarder les données clés d’un VDA | sudo /opt/Citrix/VDA/bin/xdping -b | Chaque fois que vous exécutez la commande de sauvegarde, une copie des données de sauvegarde est générée et enregistrée dans un répertoire situé sous /var/ctxbackup. Les répertoires de données de sauvegarde sont nommés selon la date et l’heure actuelles au format aaaa-mm-jj-hh_mm_ss, par exemple, 2023-02-27-16_31_27. Par défaut, le nombre maximum de répertoires de données de sauvegarde est de 30 et l’outil XDPing alterne ou supprime les anciens répertoires de données de sauvegarde lorsque ce nombre est dépassé. Pour personnaliser le nombre de répertoires, exécutez la commande suivante : sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent\Backup" -t "REG_DWORD" -v "MaxDirRotationCount" -d "0x0000005" --force
|
| Pour comparer les deux dernières copies des données de sauvegarde du VDA | sudo /opt/Citrix/VDA/bin/xdping -diff | S/O |
| Pour comparer deux copies spécifiques des données de sauvegarde du VDA | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
S/O |