Linux Virtual Delivery Agent

Intégrer avec Citrix Telemetry Service

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

Remarque :

après la mise à niveau à partir de Linux VDA 1912 et versions antérieures, vous devez réexécuter /opt/Citrix/VDA/sbin/ctxsetup.sh pour configurer les variables du service de télémétrie Citrix (ctxtelemetry). Pour plus d’informations sur les variables, reportez-vous à la section Easy Install.

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.

Vous pouvez utiliser les ports par défaut ou modifier les ports via les variables suivantes lorsque vous installez le VDA Linux.

  • CTX_XDL_TELEMETRY_SOCKET_PORT : port socket permettant d’écouter Citrix Scout. Le port par défaut est 7503.
  • CTX_XDL_TELEMETRY_PORT : port de communication avec Citrix Scout. Le port par défaut est 7502.

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 update -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServicePort" -d <port number> -t REG_DWORD
    
  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
    

    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
    
  4. Activez les nouveaux ports dans votre configuration de pare-feu.

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

Mode 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
    

    image d'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.

    image d'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
    
  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

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égrer avec Citrix Telemetry Service