Fehlerbehebung
Dieser Artikel beschreibt, wie Sie XDPing zur Fehlerbehebung verwenden und wie Sie Sitzungsmetriken mit dem Dienstprogramm ctxsdcutil abfragen.
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 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 |
|---|---|---|
| Befehlszeilenoptionen anzeigen | sudo /opt/Citrix/VDA/bin/xdping -h | N/A |
| Die vollständige Testreihe ausführen | sudo /opt/Citrix/VDA/bin/xdping (XDPing ohne Befehlszeilenoption ausführen) | 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. |
-
Eine VDA-Registrierungsstatusprüfung ausführen sudo /opt/Citrix/VDA/bin/xdping -a Weitere Informationen finden Sie unter Umfang der VDA-Registrierungsstatusprüfungen weiter unten in diesem Artikel. -
Die Schlüsseldaten eines VDA sichern sudo /opt/Citrix/VDA/bin/xdping -b Weitere Informationen finden Sie unter Sicherung und Vergleich von VDA-Daten weiter unten in diesem Artikel. -
Die letzten beiden Kopien der VDA-Sicherungsdaten vergleichen sudo /opt/Citrix/VDA/bin/xdping -diff Weitere Informationen finden Sie unter Sicherung und Vergleich von VDA-Daten weiter unten in diesem Artikel. -
Zwei spezifische Kopien der VDA-Sicherungsdaten vergleichen **sudo /opt/Citrix/VDA/bin/xdping -diff= : ** Weitere Informationen finden Sie unter Sicherung und Vergleich von VDA-Daten weiter unten in diesem Artikel. -
Die Umgebung vor der Installation des Linux-VDA-Pakets prüfen sudo /opt/Citrix/VDA/bin/xdping —preflight N/A -
Nur bestimmte Testkategorien ausführen, z. B. Zeit-, Kerberos- und Datenbanktests sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database N/A -
Einen bestimmten Delivery Controller abfragen **sudo /opt/Citrix/VDA/bin/xdping -d ** N/A -
Anzeigen, 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/A -
Anzeigen, welche Abhängigkeiten auf dem VDA installiert sind, und die Abfrageergebnisse in einem bestimmten Pfad speichern **sudo /opt/Citrix/VDA/bin/xdping -f ** oder **sudo /opt/Citrix/VDA/bin/xdping –query-pkgs-to ** N/A
Einzelne Tests
-
Das Linux-Tool XDPing führt über 150 einzelne Tests am System durch, die grob wie folgt kategorisiert werden:
- Prüfen, ob die Systemanforderungen für Linux VDA erfüllt sind.
- Maschineninformationen einschließlich der Linux-Distributionen identifizieren und anzeigen.
- Die Linux-Kernel-Kompatibilität prüfen.
- Auf bekannte Linux-Distributionsprobleme prüfen, die den Linux-VDA-Betrieb 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 virtueller Maschinen prüfen. Unterstützung für:
- XenServer (ehemals Citrix Hypervisor™)
- Microsoft HyperV
- VMware vSphere
- Zeiteinstellungen prüfen und überprüfen, ob die Netzwerkzeitsynchronisierung betriebsbereit ist.
- Prüfen, ob der PostgreSQL-Dienst ordnungsgemäß konfiguriert und betriebsbereit ist.
- Prüfen, ob SQLite ordnungsgemäß konfiguriert und betriebsbereit ist.
- Prüfen, ob die Firewall aktiviert und die erforderlichen Ports geöffnet sind.
- Kerberos-Konfiguration prüfen und Authentifizierungstests durchführen.
- Die LDAP-Suchumgebung für die Gruppenrichtliniendienst-Engine prüfen.
- Prü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
- Die Integrität des Linux-Computerobjekts im Active Directory prüfen.
- Pluggable Authentication Module (PAM)-Konfiguration prüfen.
- Das Core-Dump-Muster prüfen.
- Prüfen, ob die für den Linux VDA erforderlichen Pakete installiert sind.
- Das Linux-VDA-Paket identifizieren und die Integrität der Installation prüfen.
- Die Integrität der PostgreSQL-Registrierungsdatenbank prüfen.
- Prüfen, ob die Linux-VDA-Dienste ordnungsgemäß konfiguriert und betriebsbereit sind.
- Die Integrität der VDA- und HDX™-Konfiguration prüfen.
- Jeden konfigurierten Delivery Controller™ abfragen, um zu testen, ob der Broker Service erreichbar, betriebsbereit und reaktionsfähig ist.
- Prüfen, ob die Maschine bei der Delivery Controller-Farm registriert ist.
- Den Status jeder aktiven oder getrennten HDX-Sitzung prüfen.
- Protokolldateien auf Linux-VDA-bezogene Fehler und Warnungen scannen.
- Prüfen, ob die Version von Xorg geeignet ist.
- Prüfen, ob die erforderlichen Abhängigkeiten installiert sind.
Beispielausgabe
Im Folgenden sehen Sie eine Beispielausgabe des Kerberos-Tests:
-
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:
-
-
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 Konfigurations-, Datenbank- und Binärberechtigungsdaten. Sie können die Schlüsseldaten eines VDA sichern, wenn dieser ordnungsgemäß läuft. 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, 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/Z |
| So vergleichen Sie zwei bestimmte Kopien der VDA-Sicherungsdaten | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
N/Z |
Dienstprogramme zur Abfrage von Sitzungsmetriken
ctxsession
Dieses Dienstprogramm bietet eine Windows-Benutzererfahrung. Mit diesem Dienstprogramm können Sie auf Sitzungsmetriken zugreifen, wie im folgenden Screenshot gezeigt:
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.
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.
-
Eingangs-Sitzungsbandbreite
-
Ausgangs-Sitzungsbandbreite
-
Ausgangs-Sitzungsleitungsgeschwindigkeit
-
Latenz – zuletzt aufgezeichnet
-
Roundtrip-Zeit
-
Ausgangs-ThinWire-Bandbreite
-
Ausgangs-Audio-Bandbreite
-
Ausgangs-Drucker-Bandbreite
-
Eingangs-Laufwerksbandbreite
-
Ausgangs-Laufwerksbandbreite