Problembehandlung
In diesem Artikel wird beschrieben, wie XDPing zur Problembehandlung verwendet wird und Sitzungsdaten mit dem Dienstprogramm ctxsdcutil abgefragt werden.
XDPing
Das Linux-XDPing-Tool ist eine Befehlszeilenanwendung. Sie können damit das Prüfen auf häufige Konfigurationsprobleme in einer Linux VDA-Umgebung automatisieren.
Linux XDPing Tool installieren
XDPing wird beim Ausführen von ctxsetup.sh nicht installiert. Führen Sie den Befehl sudo /opt/Citrix/VDA/bin/xdping aus, um XDPing zu installieren.
Der Befehl erstellt auch die für XDPing erforderliche virtuelle Python3-Umgebung. Wenn keine virtuelle Python3-Umgebung erstellt wird, erstellen Sie sie manuell gemäß der Anleitung 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
Mit XDPing ausführbare Aufgaben
XDPing enthält die einzelne ausführbare Datei xdping, die über die Befehlsshell ausgeführt wird.
In der folgenden Tabelle werden die Aufgaben beschrieben, die mit den entsprechenden XDPing-Befehlen ausgeführt werden können:
| Aufgabe | XDPing-Befehl | Bemerkungen |
|---|---|---|
| Befehlszeilenoptionen anzeigen | sudo /opt/Citrix/VDA/bin/xdping -h | – |
| Gesamte Testreihe ausführen | sudo /opt/Citrix/VDA/bin/xdping (XDPing ohne Befehlszeilenoption ausführen) | Das Linux-Tool XDPing führt mehr als 150 Einzeltests im System durch. Weitere Informationen finden Sie weiter unten in diesem Artikel unter Einzelne Tests. |
| Statusprüfung der VDA-Registrierung ausführen | sudo /opt/Citrix/VDA/bin/xdping -a | Weitere Informationen finden Sie weiter unten in diesem Artikel unter Umfang der Prüfungen zum Registrierungsstatus. |
| Wichtigste VDA-Daten sichern | sudo /opt/Citrix/VDA/bin/xdping -b | Weitere Informationen finden Sie weiter unten in diesem Artikel unter Backup und Vergleich von VDA-Daten. |
| Letzte beiden Kopien der VDA-Backupdaten vergleichen | sudo /opt/Citrix/VDA/bin/xdping -diff | Weitere Informationen finden Sie weiter unten in diesem Artikel unter Backup und Vergleich von VDA-Daten. |
| Zwei spezifische Kopien von VDA-Backupdaten vergleichen | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
Weitere Informationen finden Sie weiter unten in diesem Artikel unter Backup und Vergleich von VDA-Daten. |
| Überprüfen der Umgebung, bevor Sie das Linux VDA-Paket installieren | sudo /opt/Citrix/VDA/bin/xdping –preflight | – |
| Nur bestimmte Testkategorien ausführen, z. B. Zeit-, Kerberos- und Datenbanktests | sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos,database | – |
| Bestimmten Delivery Controller testen | **sudo /opt/Citrix/VDA/bin/xdping -d |
– |
Einzelne Tests
Das Linux XDPing-Tool führt mehr als 150 Einzeltests im System durch, die wie folgt kategorisiert werden können:
- Überprüfen, ob die Systemanforderungen für Linux VDA erfüllt sind.
- Identifizieren und Anzeigen von Maschineninformationen einschließlich der Linux-Distributionen.
- Überprüfen der Linux-Kernel-Kompatibilität.
- Überprüfen, ob bekannte Probleme mit der Linux-Distribution vorliegen, die die Funktion 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 Konfiguration von Maschinenhost und Domänenname.
- Überprüfen der DNS-Konfiguration und Durchführen von Suchtests.
- Identifizieren zugrunde liegender 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 der Betriebsbereitschaft der Netzwerkzeitsynchronisierung.
- Ü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 ist und die erforderlichen Ports offen sind.
- Überprüfen der Kerberos-Konfiguration und Durchführen von Authentifizierungstests.
- Überprüfen der LDAP-Suchumgebung für die Gruppenrichtlinienengine.
- Überprüfen, ob die Active Directory-Integration ordnungsgemäß eingerichtet und die aktuelle Maschine mit der Domäne verbunden 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 PAM-Konfiguration (Pluggable Authentication Module).
- Überprüfen des Coredump-Musters.
- Überprüfen, ob alle 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.
- Test jedes konfigurierten Delivery Controllers, um zu prüfen, ob der Brokerdienst erreichbar und betriebsbereit ist und reagiert.
- Überprüfen, ob die Maschine bei der Delivery Controller-Farm registriert ist.
- Überprüfen des Zustands jeder aktiven oder getrennten HDX-Sitzung.
- Scannen von Protokolldateien auf Linux VDA-bezogene Fehler und Warnungen.
- Prüfen der Eignung der Version von Xorg.
- Überprüfen, ob die erforderlichen Abhängigkeiten installiert sind.
Beispielausgabe
Dies ist die Beispielausgabe eines ausgeführten Kerberos-Tests:
Umfang der Prüfungen zum Registrierungsstatus
Das Linux-Tool XDPing bietet auch ein Analysemodul, mit dem Sie den VDA-Registrierungsstatus überprüfen und analysieren können. Der folgende Screenshot zeigt den Umfang der Prüfungen zum Registrierungsstatus an:
Backup und Vergleich von VDA-Daten
Ab Linux VDA 2305 umfasst das Tool XDPing ein VDA-Backup-Modul. Mit diesem Modul können Sie die wichtigsten Daten eines VDAs, z. B. die Konfiguration, die Datenbank und die binären Berechtigungsdaten, jederzeit sichern. Sie können die wichtigsten Daten eines VDAs sichern, wenn 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. In der folgenden Tabelle werden VDA-Datenbackup und -Vergleich mit den XDPing-Befehlen beschrieben:
| Aufgabe | XDPing-Befehl | Bemerkungen |
|---|---|---|
| Wichtigste VDA-Daten sichern | sudo /opt/Citrix/VDA/bin/xdping -b | Jedes Mal, wenn Sie den Befehl “backup” ausführen, wird eine Kopie der Backupdaten generiert und in einem Verzeichnis unter /var/ctxbackup gespeichert. Die Verzeichnisse mit den Backupdaten werden nach dem aktuellen Datum und der aktuellen Uhrzeit im Format jjjj-mm-tt-hh_mm_ss benannt, z. B. 2023-02-27-16_31_27. Standardmäßig ist die maximale Anzahl von Backupdaten-Verzeichnissen 30 und das XDPing-Tool rotiert oder löscht alte Verzeichnisse, wenn die Anzahl überschritten wird. Führen Sie den folgenden Befehl aus, um die Nummer für die Verzeichnisrotation anzupassen: sudo /opt/Citrix/VDA/bin/ctxreg create -k "HKLM\Software\Citrix\VirtualDesktopAgent\Backup" -t "REG_DWORD" -v "MaxDirRotationCount" -d "0x0000005" --force
|
| Letzte beiden Kopien der VDA-Backupdaten vergleichen | sudo /opt/Citrix/VDA/bin/xdping -diff | – |
| Zwei spezifische Kopien von VDA-Backupdaten vergleichen | **sudo /opt/Citrix/VDA/bin/xdping -diff= |
– |
Hilfsprogramm zur Abfrage von Sitzungsdaten
Wir bieten ein Hilfsprogramm (ctxsdcutil), mit dem Sie Sitzungsdaten für jeden Linux VDA abfragen können. Führen Sie den Befehl /opt/Citrix/VDA/bin/ctxsdcutil -q <all | SessionID> [-c] aus, um die folgenden Daten aller Sitzungen oder einer bestimmten Sitzung auf einem VDA abzufragen. Das Argument [-c] bedeutet, dass Daten im Sekundentakt abgefragt werden.
-
Eingabebandbreite für Sitzung
-
Ausgabebandbreite für Sitzung
-
Ausgabeübertragungsrate für Sitzung
-
Latenz - zuletzt gemessen
-
Roundtripzeit
-
Ausgabebandbreite für Thinwire
-
Ausgabebandbreite für Audio
-
Ausgabebandbreite für Drucker
-
Eingabebandbreite für Laufwerk
-
Ausgabebandbreite für Laufwerk