Integration mit dem Citrix Telemetriedienst
Mit dem Citrix Telemetriedienst (ctxtelemetry), der in die Linux VDA-Software integriert ist, können Sie Citrix Scout ausführen, das dann das Skript /opt/Citrix/VDA/bin/xdlcollect.sh verwendet, um Protokolle über den Linux VDA zu sammeln.
Aktivieren und Deaktivieren des Citrix Telemetriedienstes
- Um den Dienst zu aktivieren, führen Sie den Befehl sudo systemctl enable ctxtelemetry.socket aus.
- Um den Dienst zu deaktivieren, führen Sie sudo systemctl disable ctxtelemetry.socket aus.
Ports
Der Citrix Telemetriedienst (ctxtelemetry) verwendet standardmäßig den TCP/IP-Port 7503, um auf Citrix Scout zu lauschen. Er verwendet den TCP/IP-Port 7502 auf dem Delivery Controller, um mit Citrix Scout zu kommunizieren.
Um Ports zu ändern, nachdem Sie Ihren VDA installiert haben, führen Sie folgende Schritte aus:
-
Um einen Port für die Kommunikation mit Scout zu ändern, führen Sie den folgenden Befehl aus.
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -t REG_DWORD -v "TelemetryServicePort" -d <port number> --force <!--NeedCopy--> -
Um den Socket-Port für das Lauschen auf Scout zu ändern, führen Sie den folgenden Befehl aus, um die Datei ctxtelemetry.socket zu öffnen und zu bearbeiten.
sudo vi /etc/systemd/system/ctxtelemetry.socket <!--NeedCopy-->
-
Führen Sie die folgenden Befehle aus, um den Socket-Port neu zu starten.
sudo systemctl daemon-reload sudo systemctl stop ctxtelemetry.socket sudo systemctl start ctxtelemetry.socket <!--NeedCopy--> -
Aktivieren Sie die neuen Ports in Ihrer Firewall-Konfiguration.
Wenn Sie beispielsweise Ubuntu verwenden, führen Sie den Befehl sudo ufw allow 7503 aus, um Port 7503 zu aktivieren.
Hinweis:
Sie können stattdessen auch ctxsetup.sh ausführen, um die vorhergehenden Schritte 3 und 4 zu automatisieren.
Debugmodus
Wenn der Citrix Telemetry Service nicht wie erwartet funktioniert, können Sie den Debugmodus aktivieren, um die Ursachen zu ermitteln.
-
Um den Debugmodus zu aktivieren, führen Sie den folgenden Befehl aus, um die
ctxtelemetry-Datei zu öffnen und dann den Wert von DebugMode auf 1 zu ändern.sudo vi /opt/Citrix/VDA/sbin/ctxtelemetry <!--NeedCopy-->
-
Beenden Sie den Citrix Telemetry Service manuell, oder warten Sie 15 Minuten, bis der Dienst automatisch beendet wird.
In diesem Beispiel können Sie die folgenden Befehle ausführen, um den Citrix Telemetry Service zu beenden.
sudo netstat -ntlp Kill -9 1958 <!--NeedCopy--> -
Um den Citrix Telemetry Service neu zu starten, wählen Sie Ihren Linux VDA in Scout aus und suchen Sie telemetry-debug.log unter /var/log/xdl/.
Dienstwartezeit
Der systemd-Daemon, der den Socket-Port öffnet, startet standardmäßig und verbraucht nur wenige Ressourcen. Der Citrix Telemetry Service wird standardmäßig beendet und startet nur, wenn eine Protokollsammlungsanforderung vom Delivery Controller vorliegt. Nach Abschluss der Protokollsammlung wartet der Dienst 15 Minuten lang auf neue Sammlungsanforderungen und wird erneut beendet, wenn keine vorhanden sind. Sie können die Wartezeit mit dem folgenden Befehl konfigurieren. Der Mindestwert beträgt 10 Minuten. Wenn Sie einen Wert unter 10 Minuten festlegen, wird der Mindestwert von 10 Minuten wirksam. Nachdem Sie die Wartezeit festgelegt haben, beenden Sie den Dienst und starten Sie ihn neu.
/opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent" -v "TelemetryServiceIdleTimeoutInMinutes" -d <number> -t REG_DWORD
<!--NeedCopy-->
Überprüfungstests
Bevor eine Sammlung beginnt, werden für jede ausgewählte Maschine automatisch Überprüfungstests ausgeführt. Diese Tests stellen sicher, dass die Anforderungen erfüllt werden. Wenn ein Test für eine Maschine fehlschlägt, zeigt Scout eine Meldung mit vorgeschlagenen Korrekturmaßnahmen an. Weitere Informationen zu Überprüfungstests finden Sie im Abschnitt Überprüfungstests in der Citrix Scout-Dokumentation.