Linux Virtual Delivery Agent 2507 LTSR

Integration mit dem Citrix Telemetriedienst

Mit dem in die Linux-VDA-Software integrierten Citrix Telemetriedienst (ctxtelemetry) 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 erfassen.

  • Citrix Scout

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 die Ports nach der Installation Ihres VDA zu ändern, gehen Sie wie folgt vor:

  1. 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-->
    
  2. 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-->
    

    Abbildung des Socket-Ports

  3. 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-->
    
  4. 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.

Debug-Modus

Wenn der Citrix Telemetriedienst nicht wie erwartet funktioniert, können Sie den Debug-Modus aktivieren, um die Ursachen zu ermitteln.

  1. Um den Debug-Modus zu aktivieren, führen Sie den folgenden Befehl aus, um die Datei ctxtelemetry zu öffnen und dann den Wert von DebugMode auf 1 zu ändern.

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

    Debug-Modus aktivieren

  2. Stoppen Sie den Citrix Telemetriedienst manuell, oder warten Sie 15 Minuten, bis der Dienst automatisch stoppt.

    Telemetrie stoppen

    In diesem Beispiel können Sie die folgenden Befehle ausführen, um den Citrix Telemetriedienst zu stoppen.

    sudo netstat -ntlp
    Kill -9 1958
    <!--NeedCopy-->
    
  3. Um den Citrix Telemetriedienst 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 Telemetriedienst stoppt standardmäßig und startet nur, wenn eine Protokollerfassungsanforderung vom Delivery Controller vorliegt. Nach Abschluss der Protokollerfassung wartet der Dienst 15 Minuten lang auf neue Erfassungsanforderungen und stoppt erneut, 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, stoppen und starten Sie den Dienst neu.

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

Verifizierungstests

Bevor eine Erfassung beginnt, werden für jede ausgewählte Maschine automatisch Verifizierungstests 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 Verifizierungstests finden Sie im Abschnitt Verifizierungstests in der Citrix Scout-Dokumentation.

Integration mit dem Citrix Telemetriedienst