故障排除
要确认 HDX Direct 已成功建立直接连接,您可以使用 VDA 计算机上的
CtxSession.exe 实用程序。
要使用
CtxSession.exe 实用程序,请在会话中启动命令提示符或 PowerShell 并运行 ctxsession.exe -v。如果 HDX Direct 连接成功建立,HDX Direct Status 为 Connected。
您还可以查看会话主机的事件日志,以了解 HDX™ Direct 连接是成功建立还是失败。有关详细信息,请参阅“事件日志”部分。
注意:
根据环境以及会话主机可用的 IP 地址数量,HDX Direct 连接可能需要长达 5 分钟才能建立。
当 HDX Direct 无法建立直接连接时
如果 HDX Direct 无法建立直接连接,请查看以下步骤:
-
确保所使用的 VDA 版本和 Workspace 应用程序版本根据系统要求支持此功能。
-
确认已向 VDA 应用了启用 HDX Direct 的策略,并且没有其他优先级更高的策略禁用此功能。
-
确认已向 VDA 应用了设置所需 HDX Direct 模式的策略,并且没有其他优先级更高的策略覆盖此配置。
-
确保 Citrix ClxMtp Service 正在会话主机上运行。
-
确保 Citrix Certificate Manager Service 正在会话主机上运行。如果未运行,请尝试手动启动它。如果 HDX Direct 被禁用,该服务将自动停止。
-
检查会话主机是否具有其自签名根 CA 证书:
-
颁发给:
CA-<hostname>(例如,CA-FTLW11-001) -
颁发者:
CA-<hostname>(例如,CA-FTLW11-001) -
颁发者详细信息: 组织为 Citrix Systems, Inc.
-
-
检查会话主机是否具有其自签名服务器证书:
-
颁发给:
<host FQDN>(例如,FTLW11-001.ctxlab.net) -
颁发者:
CA-<hostname>(例如,CA-FTLW11-001) -
颁发者详细信息: 组织为 Citrix Systems, Inc.
-
-
如果证书缺失,请联系 Citrix 技术支持。
-
如果证书存在:
-
在会话主机上停止 Citrix 证书管理器服务。
-
删除自签名根 CA 证书和自签名服务器证书。
-
在会话主机上启动 Citrix 证书管理器服务。服务启动后会创建新证书。
-
-
对于内部用户:
-
确保会话主机的防火墙未阻止 UDP 443 或 TCP 443 上的入站流量,分别用于 HDX over EDT 和 HDX over TCP。
-
确保您的网络防火墙未阻止客户端网络与会话主机网络之间 UDP 443 和 TCP 443 上的流量。
-
-
对于外部用户:
-
检查客户端和会话主机的 NAT 类型,并确保该组合能够正常工作。有关详细信息,请参阅 NAT 兼容性部分。
-
如果 NAT 测试在客户端或会话主机上失败:
-
如果系统上运行有防火墙,请确保它未阻止 UDP 3478 上的出站流量。
-
确保您的网络防火墙未阻止 UDP 3478 上的出站流量。
-
确保防火墙未阻止 STUN 服务器的响应。
-
-
确保您的网络防火墙已配置适当的规则以允许所有必要的流量。有关详细信息,请参阅网络要求部分。
-
如果您使用 HDX Direct 端口范围策略设置更改了默认端口范围,请确保您的防火墙规则已针对自定义端口范围进行设置。
-
事件日志
以下事件记录在 VDA 计算机的事件日志中:
| 日志 | ID | 源 | 级别 | 描述 |
|---|---|---|---|---|
| 应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational | 1 | HDX 直接 | 信息 | 内部用户 <username> 的 HDX Direct 连接已建立。 |
| 应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational | 2 | HDX 直接 | 信息 | 外部用户 <username> 的 HDX Direct 连接已建立。 |
| 应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational | 3 | HDX 直接 | 信息 | 用户 <username> 的 HDX Direct 连接失败。 |
| 应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational | 4 | HDX 直接 | 信息 | STUN 服务器 <URL:PORT> 为用户 <username> 提供了以下会话主机 IP 和端口映射:<IP>:<PORT>。 |
| 应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational | 5 | HDX 直接 | 信息 | 会话主机未从任何配置的 STUN 服务器收到用户 <username> 的响应。 |
| 应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational | 6 | HDX 直接 | 信息 | 客户端为用户 <username> 提供了 <IP>:<PORT> 作为外部映射。 |
| 应用程序和服务日志 > Citrix-HostCore-HDX Direct/Operational | 7 | HDX 直连 | 信息 | 客户端未为用户 <username> 提供外部映射。 |
已知问题
在已启用 HDX Direct 的计算机上执行 VDA 就地升级后,HDX Direct 可能会停止工作。 要解决此问题,请完成以下步骤:
-
在会话主机上停止 Citrix Certificate Manager 服务。
-
删除自签名根 CA 证书和自签名服务器证书。
-
打开注册表。
-
删除
HKLM\Software\Citrix\HDX-Direct项。 -
转到
HKLM\SYSTEM\CurrentControlSet\Control\TerminalServer\Wds\icawd。 -
将 SSLEnabled 值设置为
0。 -
删除 SSLThumbprint 值的内容。
-
启动 Citrix 证书管理器服务。