Linux Virtual Delivery Agent

Tools und Dienstprogramme

Dienstprogramm zur Abfrage von Sitzungsdaten

  • Wir stellen ein Dienstprogramm (ctxsdcutil) bereit, mit dem Sie Sitzungsdaten auf jedem Linux VDA abfragen können. Um die folgenden Daten aller Sitzungen oder einer bestimmten Sitzung, die auf einem VDA gehostet wird, abzufragen, führen Sie den Befehl /opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c] aus. Das Argument [-c] bedeutet, Daten jede Sekunde abzufragen.

  • Eingangsbandbreite der Sitzung

  • Ausgangsbandbreite der Sitzung

  • Leitungsgeschwindigkeit der Ausgangssitzung

  • Latenz – zuletzt aufgezeichnet

  • Roundtrip-Zeit

  • ThinWire-Ausgangsbandbreite

  • Audio-Ausgangsbandbreite

  • Drucker-Ausgangsbandbreite

  • Laufwerks-Eingangsbandbreite

  • Laufwerks-Ausgangsbandbreite

Das Bash-Skript xdlcollect

Das Bash-Skript xdlcollect zum Sammeln von Protokollen ist in die Linux VDA-Software integriert und befindet sich unter /opt/Citrix/VDA/bin. Nach der Installation des Linux VDA können Sie den Befehl bash /opt/Citrix/VDA/bin/xdlcollect.sh ausführen, um Protokolle zu sammeln. Nach Abschluss der Protokollsammlung wird eine komprimierte Protokolldatei im selben Ordner wie das Skript generiert. Das Bash-Skript xdlcollect kann Sie fragen, ob Sie die komprimierte Protokolldatei in die Citrix Insight Services (CIS) hochladen möchten. Wenn Sie zustimmen, gibt xdlcollect nach Abschluss des Uploads eine upload_ID zurück. Der Upload entfernt die komprimierte Protokolldatei nicht von Ihrem lokalen Computer. Andere Benutzer können die upload_ID verwenden, um auf die Protokolldatei in CIS zuzugreifen.

XDPing

Das Linux-Tool XDPing ist eine Befehlszeilenanwendung. Es automatisiert den Prozess der Überprüfung auf häufige Konfigurationsprobleme in einer Linux VDA-Umgebung.

Installieren des Linux-Tools XDPing

Das Ausführen von ctxsetup.sh installiert XDPing nicht. Um XDPing zu installieren, führen Sie sudo /opt/Citrix/VDA/bin/xdping aus. Dieser Befehl erstellt auch eine virtuelle Python3-Umgebung, die für XDPing erforderlich ist. Wenn dieser Befehl keine virtuelle Python3-Umgebung erstellen kann, erstellen Sie diese manuell gemäß den Anweisungen unter Erstellen einer virtuellen Python3-Umgebung.

Um SSL-Verbindungsfehler zu beheben, die bei der Verwendung des pip-Tools auftreten können, sollten Sie die folgenden vertrauenswürdigen Hosts zur Datei /etc/pip.conf hinzufügen:

[global] trusted-host = pypi.org

  • files.pythonhosted.org

  • Aufgaben, die mit XDPing ausgeführt werden können

  • XDPing wird mit der einzelnen ausführbaren Datei namens xdping geliefert, die über die Befehlszeile ausgeführt wird.

  • Die folgende Tabelle beschreibt die verschiedenen Aufgaben, die mit den entsprechenden XDPing-Befehlen ausgeführt werden können:

  • Aufgabe XDPing-Befehl Anmerkungen
  • |—|—|—|
    • Anzeigen der Befehlszeilenoptionen sudo /opt/Citrix/VDA/bin/xdping -h N/A
    • Ausführen der vollständigen Testreihe sudo /opt/Citrix/VDA/bin/xdping (führen Sie XDPing ohne Befehlszeilenoption aus) Das Linux-Tool XDPing führt über 150 einzelne Tests am System durch. Weitere Informationen finden Sie unter Einzelne Tests weiter unten in diesem Artikel.
    • Ausführen einer VDA-Registrierungsstatusprüfung sudo /opt/Citrix/VDA/bin/xdping -a Weitere Informationen finden Sie unter Umfang der VDA-Registrierungsstatusprüfungen weiter unten in diesem Artikel.
    • Sichern der Schlüsseldaten eines VDA sudo /opt/Citrix/VDA/bin/xdping -b Weitere Informationen finden Sie unter Sicherung und Vergleich von VDA-Daten weiter unten in diesem Artikel.
    • Vergleichen der letzten beiden Kopien von VDA-Sicherungsdaten sudo /opt/Citrix/VDA/bin/xdping -diff Weitere Informationen finden Sie unter Sicherung und Vergleich von VDA-Daten weiter unten in diesem Artikel.
    • Vergleichen von zwei spezifischen Kopien von VDA-Sicherungsdaten **sudo /opt/Citrix/VDA/bin/xdping -diff=:** Weitere Informationen finden Sie unter Sicherung und Vergleich von VDA-Daten weiter unten in diesem Artikel.
  • Überprüfen der Umgebung vor der Installation des Linux VDA-Pakets sudo /opt/Citrix/VDA/bin/xdping —preflight N/A
  • Ausführen nur spezifischer Testkategorien, z. B. der Zeit- und Kerberos-Tests sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos N/A
  • Abfragen eines bestimmten Delivery Controllers **sudo /opt/Citrix/VDA/bin/xdping -d ** N/A

Einzelne Tests

-  Das Linux-Tool **XDPing** führt über 150 einzelne Tests am System durch, die grob wie folgt kategorisiert werden:
  • Hinweis:

    • Das Linux-Tool XDPing führt keine SQLite-Tests durch.

    • Überprüfen, ob die Systemanforderungen des Linux VDA erfüllt sind
    • Identifizieren und Anzeigen von Maschineninformationen einschließlich der Linux-Distributionen
  • Überprüfen der Linux-Kernel-Kompatibilität
  • Überprüfen auf bekannte Probleme mit Linux-Distributionen, die den Betrieb des Linux VDA beeinträchtigen können
  • Überprüfen des Security-Enhanced Linux (SELinux)-Modus und der Kompatibilität
  • Identifizieren von Netzwerkschnittstellen und Überprüfen der Netzwerkeinstellungen
  • Überprüfen der Speicherpartitionierung und des verfügbaren Speicherplatzes
  • Überprüfen der Host- und Domänennamenkonfiguration der Maschine
  • Überprüfen der DNS-Konfiguration und Ausführen von Lookup-Tests
  • Identifizieren der zugrunde liegenden Hypervisoren und Überprüfen der Konfiguration der virtuellen Maschine. Unterstützung für:
    • Citrix Hypervisor™
    • Microsoft HyperV
    • VMware vSphere
  • Überprüfen der Zeiteinstellungen und ob die Netzwerkzeitsynchronisierung funktioniert
  • Überprüfen, ob der PostgreSQL-Dienst ordnungsgemäß konfiguriert ist und funktioniert
  • Überprüfen, ob die Firewall aktiviert ist und die erforderlichen Ports geöffnet sind
  • Überprüfen der Kerberos-Konfiguration und Ausführen von Authentifizierungstests
  • Überprüfen der LDAP-Suchumgebung für die Gruppenrichtliniendienst-Engine
  • Überprüfen, ob die Active Directory-Integration ordnungsgemäß eingerichtet ist und die aktuelle Maschine der Domäne beigetreten ist. Unterstützung für:
    • Samba Winbind
    • Dell Quest Authentication Services
    • Centrify DirectControl
    • SSSD
  • Überprüfen der Integrität des Linux-Computerobjekts in Active Directory
  • Überprüfen der Pluggable Authentication Module (PAM)-Konfiguration
  • Überprüfen des Core-Dump-Musters
  • Überprüfen, ob die vom Linux VDA benötigten Pakete installiert sind
  • Identifizieren des Linux VDA-Pakets und Überprüfen der Integrität der Installation
  • Überprüfen der Integrität der PostgreSQL-Registrierungsdatenbank
  • Überprüfen, ob die Linux VDA-Dienste ordnungsgemäß konfiguriert sind und funktionieren
  • Überprüfen der Integrität der VDA- und HDX™-Konfiguration
  • Jeden konfigurierten Delivery Controller™ abfragen, um zu testen, ob der Broker-Dienst erreichbar, funktionsfähig und reaktionsschnell ist
  • Überprüfen, ob die Maschine bei der Delivery Controller-Farm registriert ist
  • Überprüfen des Status jeder aktiven oder getrennten HDX-Sitzung
  • Durchsuchen von Protokolldateien nach Linux VDA-bezogenen Fehlern und Warnungen
  • Überprüfen, ob die Xorg-Version geeignet ist
  • Überprüfen, ob die erforderlichen Abhängigkeiten installiert sind

Beispielausgabe

Im Folgenden sehen Sie eine Beispielausgabe der Ausführung des Kerberos-Tests:

First part of the Kerberos test sample output

Second part of the Kerberos test sample output

Third part of the Kerberos test sample output

Umfang der VDA-Registrierungsstatusprüfungen

Das Linux-Tool XDPing bietet auch ein Analysemodul, das Ihnen hilft, den VDA-Registrierungsstatus zu überprüfen und zu analysieren. Den Umfang der Registrierungsstatusprüfungen finden Sie im folgenden Screenshot:

Registration status checks

Sicherung und Vergleich von VDA-Daten

Ab dem Linux VDA 2305 führt das Tool XDPing ein VDA-Sicherungsmodul ein. Dieses Modul ermöglicht es Ihnen, die Schlüsseldaten eines VDA jederzeit zu sichern, wie z. B. die Konfiguration, die Datenbank und die Daten der Binärberechtigungen. Sie können die Schlüsseldaten eines VDA sichern, während dieser ordnungsgemäß ausgeführt wird. Falls der VDA später ausfällt, sichern Sie eine weitere Kopie der Daten und vergleichen Sie die beiden Datenkopien, um die Fehlerbehebung zu erleichtern. Die folgende Tabelle beschreibt die VDA-Datensicherung und den Vergleich mit den entsprechenden XDPing-Befehlen:

Aufgabe XDPing-Befehl Anmerkungen
So sichern Sie die Schlüsseldaten eines VDA sudo /opt/Citrix/VDA/bin/xdping -b Jedes Mal, wenn Sie den Sicherungsbefehl ausführen, wird eine Kopie der Sicherungsdaten generiert und in einem Verzeichnis unter /var/ctxbackup gespeichert. Die Sicherungsdatenverzeichnisse werden nach dem aktuellen Datum und der Uhrzeit im Format jjjj-mm-tt-hh_mm_ss benannt, z. B. 2023-02-27-16_31_27. Standardmäßig beträgt die maximale Anzahl der Sicherungsdatenverzeichnisse 30, und das Tool XDPing rotiert oder löscht alte Sicherungsdatenverzeichnisse, wenn diese Anzahl überschritten wird. Um die Anzahl für die Verzeichnisrotation anzupassen, führen Sie den folgenden Befehl aus: sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent\Backup" -t "REG_DWORD" -v "MaxDirRotationCount" -d "0x0000005" --force
So vergleichen Sie die letzten beiden Kopien der VDA-Sicherungsdaten sudo /opt/Citrix/VDA/bin/xdping -diff Entfällt
So vergleichen Sie zwei spezifische Kopien der VDA-Sicherungsdaten **sudo /opt/Citrix/VDA/bin/xdping -diff=:** Entfällt
Tools und Dienstprogramme