Produktdokumentation
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDF anzeigen

Fehlerbehebung

March 18, 2026
Beitrag von: 
C

Um zu bestätigen, dass HDX Direct erfolgreich eine direkte Verbindung hergestellt hat, können Sie das Dienstprogramm CtxSession.exe auf der VDA-Maschine verwenden.

Um das Dienstprogramm CtxSession.exe zu verwenden, starten Sie eine Eingabeaufforderung oder PowerShell innerhalb der Sitzung und führen Sie ctxsession.exe -v aus. Wenn die HDX Direct-Verbindung erfolgreich hergestellt wurde, lautet der HDX Direct Status Connected.

Fehlerbehebung bei HDX Direct

Sie können auch die Ereignisprotokolle des Sitzungshosts überprüfen, um Informationen darüber zu erhalten, ob die HDX™ Direct-Verbindung erfolgreich hergestellt wurde oder fehlgeschlagen ist. Details finden Sie im Abschnitt Ereignisprotokolle.

Hinweis:

Abhängig von der Umgebung und der Anzahl der für die Sitzungshosts verfügbaren IP-Adressen kann es bis zu 5 Minuten dauern, bis die HDX Direct-Verbindung hergestellt ist.

Wenn HDX Direct keine direkte Verbindung herstellen kann

Wenn HDX Direct keine direkte Verbindung herstellen kann, überprüfen Sie die folgenden Schritte:

  1. Stellen Sie sicher, dass die verwendete VDA-Version und Workspace-App-Version die Funktion gemäß den Systemanforderungen unterstützen.
  2. Bestätigen Sie, dass eine Richtlinie auf den VDA angewendet wird, die HDX Direct aktiviert, und dass keine anderen Richtlinien mit höherer Priorität die Funktion deaktivieren.
  3. Bestätigen Sie, dass eine Richtlinie auf den VDA angewendet wird, die den gewünschten HDX Direct-Modus festlegt, und dass keine anderen Richtlinien mit höherer Priorität die Konfiguration überschreiben.
  4. Stellen Sie sicher, dass der Citrix ClxMtp Service auf dem Sitzungshost ausgeführt wird.
  5. Stellen Sie sicher, dass der Citrix Certificate Manager Service auf dem Sitzungshost ausgeführt wird. Wenn er nicht ausgeführt wird, versuchen Sie, ihn manuell zu starten. Der Dienst wird automatisch beendet, wenn HDX Direct deaktiviert ist.
  6. Überprüfen Sie, ob der Sitzungshost über sein selbstsigniertes Stamm-CA-Zertifikat verfügt:
    1. Ausgestellt für: CA-Citrix-Certificate-Manager
    2. Ausgestellt von: CA-Citrix-Certificate-Manager
    3. Ausstellerdetails: Die Organisation ist Citrix Systems, Inc.
  7. Überprüfen Sie, ob der Sitzungshost über sein selbstsigniertes Serverzertifikat verfügt:
    1. Ausgestellt für: <Host-FQDN> (Zum Beispiel FTLW11-001.ctxlab.net)
    2. Ausgestellt von: CA-Citrix-Certificate-Manager
    3. Ausstellerdetails: Die Organisation ist Citrix Systems, Inc.
  8. Wenn die Zertifikate fehlen, wenden Sie sich an den Citrix Tech Support.
  9. Wenn die Zertifikate vorhanden sind:
    1. Beenden Sie den Citrix Certificate Manager Service auf dem Sitzungshost.
    2. Löschen Sie sowohl das selbstsignierte Stamm-CA-Zertifikat als auch das selbstsignierte Serverzertifikat.
    3. Starten Sie den Citrix Certificate Manager Service auf dem Sitzungshost. Der Dienst erstellt neue Zertifikate, sobald er startet.
  10. Für interne Benutzer:
    1. Stellen Sie sicher, dass die Firewall des Sitzungshosts den eingehenden Datenverkehr auf UDP 443 oder TCP 443 für HDX über EDT bzw. HDX über TCP nicht blockiert.
    2. Stellen Sie sicher, dass Ihre Netzwerk-Firewall den Datenverkehr auf UDP 443 und TCP 443 zwischen dem Netzwerk Ihrer Clients und dem Netzwerk der Sitzungshosts nicht blockiert.
  11. Für externe Benutzer:
    1. Überprüfen Sie, ob der Sitzungshost die Liste der STUN-Server enthält:
      • Schlüssel: HKLM\SOFTWARE\Citrix\HDX-Direct
      • Werttyp: REG_MULTI_SZ
      • Wertname: STUNServers
      • Daten: stun.cloud.com:3478 stun.cloudflare.com:3478 stun.l.google.com:19302
    2. Überprüfen Sie den NAT-Typ für den Client und den Sitzungshost und stellen Sie sicher, dass die Kombination voraussichtlich funktioniert. Details finden Sie im Abschnitt NAT-Kompatibilität.
    3. Wenn der NAT-Test auf dem Client oder dem Sitzungshost fehlschlägt:
      1. Wenn eine Firewall auf dem System ausgeführt wird, stellen Sie sicher, dass sie den ausgehenden Datenverkehr auf UDP 3478 nicht blockiert.
      2. Stellen Sie sicher, dass Ihre Netzwerk-Firewalls den ausgehenden Datenverkehr auf UDP 3478 nicht blockieren.
      3. Stellen Sie sicher, dass die Firewalls die Antwort des STUN-Servers nicht blockieren.
    4. Stellen Sie sicher, dass Ihre Netzwerk-Firewalls die entsprechenden Regeln konfiguriert haben, um den gesamten notwendigen Datenverkehr zuzulassen. Details finden Sie im Abschnitt Netzwerkanforderungen.
    5. Wenn Sie den Standardportbereich mithilfe der HDX Direct-Portbereichsrichtlinieneinstellung ändern, stellen Sie sicher, dass Ihre Firewallregeln für den benutzerdefinierten Portbereich festgelegt sind.

Ereignisprotokolle

Die folgenden Ereignisse werden im Ereignisprotokoll der VDA-Maschine protokolliert:

| Protokoll | ID | Quelle | Ebene | Beschreibung | | — | — | — | – | – | | Anwendungs- und Dienstprotokolle > Citrix-HostCore-HDX Direct/Operational | 1 | HDX Direct | Information | HDX Direct-Verbindung für internen Benutzer <username> hergestellt. | | Anwendungs- und Dienstprotokolle > Citrix-HostCore-HDX Direct/Operational | 2 | HDX Direct | Information | HDX Direct-Verbindung für externen Benutzer <username> hergestellt. | | Anwendungs- und Dienstprotokolle > Citrix-HostCore-HDX Direct/Operational | 3 | HDX Direct | Information | HDX Direct-Verbindung für Benutzer <username> fehlgeschlagen. | | Anwendungs- und Dienstprotokolle > Citrix-HostCore-HDX Direct/Operational | 4 | HDX Direct | Information | STUN-Server <URL:PORT> stellte die folgende Sitzungshost-IP- und PORT-Zuordnung für Benutzer <username> bereit: <IP>:<PORT>. | | Anwendungs- und Dienstprotokolle > Citrix-HostCore-HDX Direct/Operational | 5 | HDX Direct | Information | Keine Antwort vom Sitzungshost von einem der konfigurierten STUN-Server für Benutzer <username> erhalten. | | Anwendungs- und Dienstprotokolle > Citrix-HostCore-HDX Direct/Operational | 6 | HDX Direct | Information | Client stellte <IP>:<PORT> als externe Zuordnung für Benutzer <username> bereit. | | Anwendungs- und Dienstprotokolle > Citrix-HostCore-HDX Direct/Operational | 7 | HDX Direct | Information | Keine externe Zuordnung wurde vom Client für Benutzer <username> bereitgestellt. |

Bekannte Probleme

  • HDX Direct für externe Benutzer kann in Umgebungen fehlschlagen, die Workspace mit Gateway Service verwenden, wenn Rendezvous deaktiviert ist. Um dieses Problem zu beheben, stellen Sie sicher, dass Rendezvous aktiviert ist.

  • HDX Direct funktioniert möglicherweise nicht mehr, nachdem ein In-Place-Upgrade des VDA auf einer Maschine durchgeführt wurde, auf der HDX Direct bereits aktiviert ist. Um das Problem zu beheben, führen Sie die folgenden Schritte aus:

    1. Beenden Sie den Citrix Certificate Manager Service auf dem Sitzungshost.
    2. Löschen Sie das selbstsignierte Stamm-CA-Zertifikat und das selbstsignierte Serverzertifikat.
    3. Öffnen Sie die Registrierung.
    4. Löschen Sie den Schlüssel HKLM\Software\Citrix\HDX-Direct.
    5. Gehen Sie zu HKLM\SYSTEM\CurrentControlSet\Control\TerminalServer\Wds\icawd.
    6. Setzen Sie den Wert SSLEnabled auf 0.
    7. Löschen Sie den Inhalt des Werts SSLThumbprint.
    8. Starten Sie den Citrix Certificate Manager Service.
Fehlerbehebung
March 18, 2026
Beitrag von: 
C
March 18, 2026
Beitrag von: 
C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.