Agent de livraison virtuel Linux 2507 LTSR

Intégration avec le service de télémétrie Citrix

Avec le service de télémétrie Citrix (ctxtelemetry) intégré au logiciel Linux VDA, vous pouvez exécuter Citrix Scout, qui utilise ensuite le script /opt/Citrix/VDA/bin/xdlcollect.sh pour collecter les journaux concernant le Linux VDA.

  • 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 la commande sudo systemctl disable ctxtelemetry.socket.

Ports

Le service de télémétrie Citrix (ctxtelemetry) utilise par défaut 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 l’installation de 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 la configuration de votre 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 pour automatiser les étapes 3 et 4 précédentes.

Mode débogage

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

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

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

    Activer le mode 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êter 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 Linux VDA sur Scout et recherchez telemetry-debug.log dans /var/log/xdl/.

Temps d’attente du service

Le démon systemd qui ouvre le port de 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 ne démarre que lorsqu’il y a une demande de collecte de journaux de la part du Delivery Controller. Une fois la collecte des journaux terminée, le service attend de nouvelles demandes de collecte pendant 15 minutes et s’arrête à nouveau s’il n’y en a pas. Vous pouvez configurer le temps d’attente à l’aide de la commande suivante. La valeur minimale est de 10 minutes. Si vous définissez une valeur inférieure à 10 minutes, la valeur minimale de 10 minutes prend effet. Après avoir défini le temps 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ébut d’une collecte, des tests de vérification s’exécutent automatiquement pour chaque machine sélectionnée. Ces tests garantissent que les exigences sont satisfaites. Si un test échoue pour une machine, Scout affiche un message avec des actions correctives suggérées. Pour plus d’informations sur les tests de vérification, consultez la section Tests de vérification dans la documentation de Citrix Scout.

Intégration avec le service de télémétrie Citrix