Dépannage

Dernière publication : Nov 13, 2026
Pour confirmer que HDX Direct a établi une connexion directe avec succès, vous pouvez utiliser l'utilitaire CtxSession.exe sur la machine VDA.
Related information
../hdx-transport/hdx-direct.md

<<<<<<<< HEAD:fr-fr/citrix-virtual-apps-desktops/current-release/hdx-transport/hdx-direct-troubleshooting.md <<<<<<<< HEAD:fr-fr/citrix-virtual-apps-desktops/current-release/hdx-transport/hdx-direct-troubleshooting.md Pour utiliser l'utilitaire CtxSession.exe, lancez une invite de commandes ou PowerShell dans la session et exécutez ctxsession.exe -v. Si la connexion HDX Direct est établie avec succès, HDX Direct Status est Connected.

Pour utiliser l'utilitaire CtxSession.exe, lancez une invite de commandes ou PowerShell dans la session et exécutez ctxsession.exe -v. Si la connexion HDX Direct est établie avec succès, le statut HDX Direct est Connected.
Dépannage HDX Direct
Vous pouvez également consulter les journaux d'événements de l'hôte de session pour savoir si la connexion HDX™ Direct a été établie avec succès ou a échoué. Consultez la section Journaux d'événements pour plus de détails.
Remarque :
Selon l'environnement et le nombre d'adresses IP disponibles pour les hôtes de session, l'établissement de la connexion HDX Direct peut prendre jusqu'à 5 minutes.

Lorsque HDX Direct ne parvient pas à établir une connexion directe

Si HDX Direct ne parvient pas à établir une connexion directe, examinez les étapes suivantes :
  1. Assurez-vous que la version du VDA et la version de l'application Workspace utilisées prennent en charge la fonctionnalité conformément aux exigences système.
  2. Confirmez qu'une stratégie est appliquée au VDA qui active HDX Direct et qu'aucune autre stratégie de priorité plus élevée ne désactive la fonctionnalité.
  3. Confirmez qu'une stratégie est appliquée au VDA qui définit le mode HDX Direct souhaité et qu'aucune autre stratégie de priorité plus élevée ne remplace la configuration.
  4. Assurez-vous que le service Citrix ClxMtp est en cours d'exécution sur l'hôte de session.
  5. Assurez-vous que le service Citrix Certificate Manager est en cours d'exécution sur l'hôte de session. S'il n'est pas en cours d'exécution, essayez de le démarrer manuellement. Le service s'arrête automatiquement si HDX Direct est désactivé.
  6. Vérifiez si l'hôte de session possède son certificat d'autorité de certification racine auto-signé :
    1. Délivré à : CA-Citrix-Certificate-Manager <<<<<<<< HEAD:fr-fr/citrix-virtual-apps-desktops/current-release/hdx-transport/hdx-direct-troubleshooting.md
    2. Émis par : CA-Citrix-Certificate-Manager
    3. Détails de l'émetteur : L'organisation est Citrix Systems, Inc.
  7. Vérifiez si l'hôte de session possède son certificat de serveur auto-signé :
    1. Émis à : <host FQDN> (Par exemple, FTLW11-001.ctxlab.net)

Journaux d'événements

Les événements suivants sont enregistrés dans le journal des événements de la machine VDA :
Journal ID Source Niveau Description
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 1 HDX Direct Informations Connexion HDX Direct pour l'utilisateur interne <username> établie.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 2 HDX Direct Informations Connexion HDX Direct pour l'utilisateur externe <username> établie.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 3 HDX Direct Informations La connexion HDX Direct pour l'utilisateur <username> a échoué.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 4 HDX Direct Informations Le serveur STUN <URL:PORT> a fourni les informations suivantes de mappage IP et de port de l'hôte de session pour l'utilisateur <username> : <IP>:<PORT>.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 5 HDX Direct Informations Aucune réponse n'a été reçue par l'hôte de session d'aucun des serveurs STUN configurés pour l'utilisateur <username>.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 6 HDX Direct Informations Le client a fourni <IP>:<PORT> comme mappage externe pour l'utilisateur <username>.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 7 HDX Direct Informations Aucun mappage externe n'a été fourni par le client pour l'utilisateur <username>.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Opérationnel 1 HDX Direct Information Connexion HDX Direct pour l'utilisateur interne <username> établie.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Opérationnel 2 HDX Direct Information Connexion HDX Direct pour l'utilisateur externe <username> établie.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 3 HDX Direct Informations La connexion HDX Direct pour l'utilisateur <username> a échoué.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 4 HDX Direct Informations Le serveur STUN <URL:PORT> a fourni le mappage d'IP et de PORT de l'hôte de session suivant pour l'utilisateur <username> : <IP>:<PORT>.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 5 HDX Direct Informations Aucune réponse reçue par l'hôte de session d'aucun des serveurs STUN configurés pour l'utilisateur <username>.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 6 HDX Direct Information Le client a fourni <IP>:<PORT> comme mappage externe pour l'utilisateur <username>.
Journaux des applications et des services > Citrix-HostCore-HDX Direct/Operational 7 HDX Direct Information Aucun mappage externe n'a été fourni par le client pour l'utilisateur <username>.

Problèmes connus

  • HDX Direct pour les utilisateurs externes peut échouer dans les environnements qui utilisent Workspace avec Gateway Service si Rendezvous est désactivé. Pour résoudre ce problème, assurez-vous que Rendezvous est activé.
  • HDX Direct peut cesser de fonctionner après avoir effectué une mise à niveau sur place du VDA sur une machine sur laquelle HDX Direct est déjà activé. Pour résoudre le problème, suivez les étapes suivantes :
    1. Arrêtez le service Citrix Certificate Manager sur l'hôte de session.
    2. Supprimez le certificat d'autorité de certification racine auto-signé et le certificat de serveur auto-signé.
    3. Ouvrez le registre.
    4. Supprimez la clé HKLM\Software\Citrix\HDX-Direct.
    5. Accédez à HKLM\SYSTEM\CurrentControlSet\Control\TerminalServer\Wds\icawd.
    6. Définissez la valeur SSLEnabled sur 0.
    7. Supprimez le contenu de la valeur SSLThumbprint.
    8. Démarrez le Citrix Certificate Manager Service.