Fehlerbehebung
Dieser Artikel beschreibt, wie Sie XDPing zur Fehlerbehebung und das Dienstprogramm ctxsdcutil zur Abfrage von Sitzungsdaten 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 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, fügen Sie die folgenden vertrauenswürdigen Hosts zur Datei /etc/pip.conf hinzu:
[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 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 Testsuite sudo /opt/Citrix/VDA/bin/xdping (führen Sie XDPing ohne Befehlszeilenoption aus) 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. -
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. Zeit-, Kerberos- und Datenbanktests sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database 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 auf dem System durch, die grob wie folgt kategorisiert sind:
- Ü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 Maschinenhost- und Domänennamenkonfiguration.
- Überprüfen der DNS-Konfiguration und Durchführen von Lookup-Tests.
- Identifizieren der zugrunde liegenden Hypervisoren und Überprüfen der Konfiguration virtueller Maschinen. Unterstützung für:
- XenServer (ehemals Citrix Hypervisor™)
- Microsoft HyperV
- VMware vSphere
- Überprüfen der Zeiteinstellungen und ob die Netzwerkzeitsynchronisation betriebsbereit ist.
- Überprüfen, ob der PostgreSQL-Dienst ordnungsgemäß konfiguriert und betriebsbereit ist.
- Überprüfen, ob SQLite ordnungsgemäß konfiguriert und betriebsbereit ist.
- Überprüfen, ob die Firewall aktiviert und die erforderlichen Ports geöffnet sind.
- Überprüfen der Kerberos-Konfiguration und Durchfü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 im 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 und betriebsbereit sind.
- Überprüfen der Integrität der VDA- und HDX™-Konfiguration.
- Abfragen jedes konfigurierten Delivery Controller™ zur Überprüfung, ob der Broker-Dienst erreichbar, betriebsbereit 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:
-
-
-
-
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. Eine Übersicht über die 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. Konfigurations-, Datenbank- und Binärberechtigungsdaten. 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 VDA-Datensicherung und den Vergleich mit den entsprechenden XDPing-Befehlen:
| Aufgabe | XDPing-Befehl | Anmerkungen |
|---|---|---|
| Sichern der 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 XDPing-Tool rotiert oder löscht alte Sicherungsdatenverzeichnisse, wenn die 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
|
| Vergleichen der letzten beiden Kopien von VDA-Sicherungsdaten | sudo /opt/Citrix/VDA/bin/xdping -diff | N/A |
| Zum Vergleich von zwei spezifischen Kopien von VDA-Sicherungsdaten | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
N/A |
Dienstprogramm zur Abfrage von Sitzungsdaten
Wir stellen ein Dienstprogramm (ctxsdcutil) bereit, das Sie verwenden können, um Sitzungsdaten auf jedem Linux VDA abzufragen. 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.
-
Eingangs-Sitzungsbandbreite
-
Ausgangs-Sitzungsbandbreite
-
Ausgangs-Sitzungsleitungsgeschwindigkeit
-
Latenz – Zuletzt aufgezeichnet
-
Roundtrip-Zeit
-
Ausgangs-ThinWire-Bandbreite
-
Ausgangs-Audio-Bandbreite
-
Ausgangs-Druckerbandbreite
-
Eingangs-Laufwerksbandbreite
-
Ausgangs-Laufwerksbandbreite