Documentation produit
Linux Virtual Delivery Agent
Current Release 2402 LTSR 2311 2308 2305 2303 2301 2212 2210 2209 2207 2206 2204 2203 LTSR 1912 LTSR 7.15 LTSR
Voir PDF

Intégration avec Citrix Telemetry Service

July 15, 2024
Contributeur: 
C

Avec Citrix Telemetry Service (ctxtelemetry) intégré au logiciel VDA Linux, vous pouvez exécuter Citrix Scout, qui utilise ensuite le script /opt/Citrix/vda/bin/xdlcollect.sh, pour collecter des journaux sur le VDA Linux.

Image de Citrix Scout

Activer et désactiver le service de télémétrie Citrix

  • Pour activer le service, exécutez la commande sudo systemctl enable ctxtelemetry.socket.
  • Pour désactiver le service, exécutez sudo systemctl disable ctxtelemetry.socket.

Ports

Le service de télémétrie Citrix (ctxtelemetry), par défaut, utilise le port TCP/IP 7503 pour écouter Citrix Scout. Il utilise le port TCP/IP 7502 sur le Delivery Controller pour communiquer avec Citrix Scout.

Pour modifier les ports après avoir installé votre VDA, procédez comme suit :

  1. Pour modifier un port de communication avec Scout, exécutez la commande suivante.

    /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t REG_DWORD -v "TelemetryServicePort" -d <port number> --force
<!--NeedCopy-->

  2. Pour modifier le port de socket pour l’écoute de Scout, exécutez la commande suivante pour ouvrir et modifier le fichier ctxtelemetry.socket.

    sudo vi /etc/systemd/system/ctxtelemetry.socket
<!--NeedCopy-->

    image du port de socket

  3. Exécutez les commandes suivantes pour redémarrer le port de socket.

    sudo systemctl daemon-reload
sudo systemctl stop ctxtelemetry.socket
sudo systemctl start ctxtelemetry.socket
<!--NeedCopy-->

  4. Activez les nouveaux ports dans votre configuration de pare-feu.

    Si vous utilisez Ubuntu, par exemple, exécutez la commande sudo ufw allow 7503 pour activer le port 7503.

Remarque :

Vous pouvez également exécuter ctxsetup.sh à la place pour automatiser les étapes 3 et 4 précédentes.

Mode de débogage

Si le service de télémétrie Citrix ne fonctionne pas comme prévu, vous pouvez activer le mode de débogage pour en déterminer les causes.

  1. Pour activer le mode de débogage, exécutez la commande suivante pour ouvrir le fichier ctxtelemetry, puis modifiez la valeur DebugMode sur 1.

    sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry
<!--NeedCopy-->

    Activation du mode de débogage

  2. Arrêtez manuellement le service de télémétrie Citrix ou attendez 15 minutes que le service s’arrête automatiquement.

    Arrêt de la télémétrie

    Dans cet exemple, vous pouvez exécuter les commandes suivantes pour arrêter le service de télémétrie Citrix.

    sudo netstat -ntlp
Kill -9 1958
<!--NeedCopy-->

  3. Pour redémarrer le service de télémétrie Citrix, sélectionnez votre VDA Linux sur Scout et recherchez telemetry-debug.log dans /var/log/xdl/.

Délai d’attente du service

Le démon systemd qui ouvre le port socket démarre par défaut et utilise peu de ressources. Le service de télémétrie Citrix s’arrête par défaut et démarre uniquement lorsqu’il existe une demande de collecte de journaux à partir du Delivery Controller. Une fois la collecte des journaux terminée, le service attend les nouvelles demandes de collecte pendant 15 minutes et s’arrête à nouveau s’il n’y en a pas. Vous pouvez configurer le délai d’attente via la commande suivante. La valeur minimale est de 10 minutes. Si vous définissez une valeur inférieure à 10 minutes, la valeur minimale, 10 minutes, est appliquée. Après avoir défini le délai d’attente, arrêtez et redémarrez le service.

/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServiceIdleTimeoutInMinutes" -d <number> -t REG_DWORD
<!--NeedCopy-->

Tests de vérification

Avant le démarrage d’une collecte, des tests de vérification sont exécutés automatiquement pour chaque machine sélectionnée. Ces tests garantissent que les conditions requises sont remplies. Si un test échoue pour une machine, Scout affiche un message avec actions correctives proposées. Pour plus d’informations sur les tests de vérification, consultez la section Tests de vérification de la documentation Citrix Scout.

Intégration avec Citrix Telemetry Service
July 15, 2024
Contributeur: 
C
July 15, 2024
Contributeur: 
C

Dans cet article

Commentaires sur le site | Your privacy choices footer linkVos préférences de confidentialité | Confidentialité et conditions légales | Préférences de cookies | Paramètres de consentement | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.