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 ** oder **sudo /opt/Citrix/VDA/bin/xdping –query-pkgs-to ** 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:

Der erste Teil der Beispielausgabe des Kerberos-Tests

Der zweite Teil der Kerberos-Testausgabe

Der dritte Teil der Kerberos-Testausgabe

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:

Prüfungen des Registrierungsstatus

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:

Sitzungsmetriken über **ctxsession** abfragen

Dienstprogramme: ctxqsession, ctxquser, ctxqfull, ctxquery

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

Hilfeinformationen zum Dienstprogramm

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

Fehlerbehebung