Fehlerbehebung
Dieser Artikel beschreibt, wie Sie XDPing zur Fehlerbehebung und das Dienstprogramm ctxsdcutil zur Abfrage von Sitzungsmetriken verwenden.
XDPing
Das Linux-Tool XDPing ist eine Befehlszeilenanwendung. Es automatisiert die Ü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 Python3-virtuelle Umgebung, die für XDPing erforderlich ist. Wenn dieser Befehl keine Python3-virtuelle Umgebung erstellen kann, erstellen Sie diese manuell gemäß den Anweisungen unter Erstellen einer Python3-virtuellen 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
Mit XDPing ausführbare Aufgaben
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 |
| Um die vollständige Testreihe auszuführen | sudo /opt/Citrix/VDA/bin/xdping (XDPing ohne Befehlszeilenoption ausführen) | Das Linux-Tool XDPing führt über 150 einzelne Tests auf dem System durch. Weitere Informationen finden Sie unter Einzelne Tests weiter unten in diesem Artikel. |
| Zum Ausführen einer VDA-Registrierungsstatusprüfung | sudo /opt/Citrix/VDA/bin/xdping -a | Weitere Informationen finden Sie unter Umfang der Registrierungsstatusprüfungen weiter unten in diesem Artikel. |
| Zum 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. |
| Zum Vergleichen der letzten beiden Kopien der 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. |
| Zum Vergleichen von zwei spezifischen Kopien der 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. |
| So überprüfen Sie die Umgebung vor der Installation des Linux VDA-Pakets | sudo /opt/Citrix/VDA/bin/xdping –preflight | N. zutr. |
| So führen Sie nur bestimmte Testkategorien aus, z. B. Zeit-, Kerberos- und Datenbanktests | sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database | N. zutr. |
| So prüfen Sie einen bestimmten Delivery Controller | **sudo /opt/Citrix/VDA/bin/xdping -d |
N. zutr. |
| So zeigen Sie an, welche Abhängigkeiten auf dem VDA installiert sind | sudo /opt/Citrix/VDA/bin/xdping –query-pkgs oder sudo /opt/Citrix/VDA/bin/xdping -q | N. zutr. |
| So zeigen Sie an, welche Abhängigkeiten auf dem VDA installiert sind, und speichern die Abfrageergebnisse in einem bestimmten Pfad | **sudo /opt/Citrix/VDA/bin/xdping -f |
N/A |
Einzelne Tests
Das Linux-Tool XDPing führt über 150 einzelne Tests auf dem System durch, die grob wie folgt kategorisiert sind:
- Prüfen, ob die Systemanforderungen für Linux VDA erfüllt sind.
- Maschineninformationen identifizieren und anzeigen, einschließlich der Linux-Distributionen.
- Die Linux-Kernel-Kompatibilität prüfen.
- Auf bekannte Probleme mit Linux-Distributionen prüfen, die den Betrieb des Linux VDA beeinträchtigen können.
- Den Security-Enhanced Linux (SELinux)-Modus und die Kompatibilität prüfen.
- Netzwerkschnittstellen identifizieren und Netzwerkeinstellungen prüfen.
- Speicherpartitionierung und verfügbaren Speicherplatz prüfen.
- Maschinen-Host- und Domänennamenkonfiguration prüfen.
- DNS-Konfiguration prüfen und Lookup-Tests durchführen.
- Zugrunde liegende Hypervisoren identifizieren und die Konfiguration der virtuellen Maschine prüfen. Unterstützung für:
- XenServer (ehemals Citrix Hypervisor™)
- Microsoft HyperV
- VMware vSphere
- Uhrzeiteinstellungen prüfen und überprüfen, ob die Netzwerkzeitsynchronisierung betriebsbereit ist.
- Überprüfen Sie, ob der PostgreSQL-Dienst ordnungsgemäß konfiguriert und betriebsbereit ist.
- Überprüfen Sie, ob SQLite ordnungsgemäß konfiguriert und betriebsbereit ist.
- Überprüfen Sie, ob die Firewall aktiviert und die erforderlichen Ports geöffnet sind.
- Kerberos-Konfiguration prüfen und Authentifizierungstests durchführen.
- Überprüfen Sie die LDAP-Suchumgebung für die Gruppenrichtliniendienst-Engine.
- Überprüfen Sie, ob die Active Directory-Integration ordnungsgemäß eingerichtet ist und der aktuelle Computer der Domäne beigetreten ist. Unterstützung für:
- Samba Winbind
- Dell Quest Authentication Services
- Centrify DirectControl
- SSSD
- Überprüfen Sie die Integrität des Linux-Computerobjekts im Active Directory.
- Überprüfen Sie die Konfiguration des Pluggable Authentication Module (PAM).
- Überprüfen Sie das Core-Dump-Muster.
- Überprüfen Sie, ob die vom Linux VDA benötigten Pakete installiert sind.
- Identifizieren Sie das Linux VDA-Paket und überprüfen Sie die Integrität der Installation.
- Überprüfen Sie die Integrität der PostgreSQL-Registrierungsdatenbank.
- Überprüfen Sie, ob die Linux VDA-Dienste ordnungsgemäß konfiguriert und betriebsbereit sind.
- Überprüfen Sie die Integrität der VDA- und HDX™-Konfiguration.
- Testen Sie jeden konfigurierten Delivery Controller™, um zu prüfen, ob der Broker Service erreichbar, betriebsbereit und reaktionsschnell ist.
- Überprüfen Sie, ob die Maschine bei der Delivery Controller-Farm registriert ist.
- Überprüfen Sie den Status jeder aktiven oder getrennten HDX-Sitzung.
- Durchsuchen Sie Protokolldateien nach Linux VDA-bezogenen Fehlern und Warnungen.
- Überprüfen Sie, ob die Xorg-Version geeignet ist.
- Überprüfen Sie, ob die erforderlichen Abhängigkeiten installiert sind.
Beispielausgabe
Im Folgenden sehen Sie eine Beispielausgabe der Ausführung des Kerberos-Tests:



Umfang der VDA-Registrierungsstatusprüfungen
Das Linux-Tool XDPing bietet auch ein Analysemodul, mit dem Sie den VDA-Registrierungsstatus überprüfen und analysieren können. Eine Übersicht über den Umfang der Registrierungsstatusprüfungen finden Sie im folgenden Screenshot:

Sicherung und Vergleich von VDA-Daten
Ab Linux VDA 2305 führt das XDPing-Tool ein VDA-Sicherungsmodul ein. Dieses Modul ermöglicht es Ihnen, die Schlüsseldaten eines VDA jederzeit zu sichern, z. B. die Konfiguration, die Datenbank und die binären Berechtigungsdaten. Sie können die Schlüsseldaten eines VDA sichern, wenn er 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 Sicherung und den Vergleich von VDA-Daten 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, zum Beispiel 2023-02-27-16_31_27. Standardmäßig beträgt die maximale Anzahl der Sicherungsdatenverzeichnisse 30, und das XDPing-Tool 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 | N/A |
| Zum Vergleichen von zwei spezifischen Kopien von VDA-Sicherungsdaten | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
N/A |
Dienstprogramme zur Abfrage von Sitzungsmetriken
ctxsitzung
Dieses Dienstprogramm bietet eine Windows-Benutzererfahrung. Mit diesem Dienstprogramm können Sie auf Sitzungsmetriken zugreifen, wie im folgenden Screenshot gezeigt:

Dienstprogramme: ctxqsession, ctxquser, ctxqfull, ctxquery
Anweisungen zur Verwendung dieser Dienstprogramme erhalten Sie, indem Sie den Hilfebefehl ausführen, zum Beispiel:

Benutzer können nur ihre eigenen Sitzungsmetriken abfragen. Nur Root-Benutzer und Benutzer der Gruppe ctxadm haben die Berechtigung, die Sitzungsmetriken anderer Benutzer abzufragen.
Dienstprogramm: ctxsdcutil
Dieses Dienstprogramm hilft, die folgenden Metriken aller Sitzungen oder einer bestimmten Sitzung, die auf einem VDA gehostet wird, abzufragen. Führen Sie dazu den Befehl /opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c] aus. Das Argument [-c] bedeutet, Metriken jede Sekunde abzufragen.
-
Eingabe-Sitzungsbandbreite
-
Ausgabe-Sitzungsbandbreite
-
Ausgabe-Sitzungsleitungsgeschwindigkeit
-
Latenz – zuletzt aufgezeichnet
-
Roundtrip-Zeit
-
Ausgabe-ThinWire-Bandbreite
-
Ausgabe-Audiobandbreite
-
Ausgabe-Druckerbandbreite
-
Eingabe-Laufwerksbandbreite
-
Ausgabe-Laufwerksbandbreite