思杰 Director 故障原因和故障排除

下表描述了各种故障类别、原因以及解决问题所需采取的操作。有关详细信息,请参阅 枚举、错误代码和说明

连接失败的错误

类别 原因 问题 操作
不适用 [0] 未知。此错误代码未映射。 监控服务无法根据 Brokering 服务共享的信息确定报告的启动或连接失败的原因。 在控制器上收集 CDF 日志并联系 Citrix 支持。
[0] 无 [1] 无 不适用
[2] 计算机故障 [2] 会话准备 交付控制器向 VDA 发送的会话准备请求失败。可能的原因:控制器与 VDA 之间的通信问题、Broker Service 在创建准备请求时遇到的问题,或导致 VDA 不接受请求的网络问题。 请参阅知识中心文章 Citrix Virtual Apps and Desktops 中虚拟投递代理与交付控制器注册故障排除 中列出的故障排除步骤,了解导致控制器与 VDA 之间通信问题的常见问题。
[2] 计算机故障 [3] 注册超时 VDA 已经启动,但在其尝试向交付控制器注册时发生了超时。 验证 Citrix Broker Service 是否在交付控制器上运行,以及 Desktop Service 是否在 VDA 上运行。如果已停止,请启动它们。
[1] 客户端连接失败 [4] 连接超时 VDA 准备好启动会话后,客户端未能连接到 VDA。会话已成功代理,但在等待客户端连接到 VDA 时发生超时。可能的原因:防火墙设置、网络中断或阻止远程连接的设置。 检查 Director 控制台,查看客户端当前是否有活动连接,这意味着没有用户受到影响。如果不存在会话,请检查客户端和 VDA 上的事件日志以查找任何错误。解决客户端与 VDA 之间的任何网络连接问题。
[4] 无可用许可证 [5] 许可 许可请求失败。可能的原因:许可证数量不足,或许可证服务器已停机超过 30 天。 验证许可证服务器是否在线且可访问。解决与许可证服务器的任何网络连接问题,或者如果许可证服务器出现故障,请重新启动它。验证环境中是否有足够的许可证,并在必要时分配更多。
[1] 客户端连接失败 [6] 票证 票证处理期间发生故障,表明客户端与 VDA 的连接与代理请求不匹配。启动请求票证由 Broker 准备并以 ICA® 文件的形式交付。当用户尝试启动会话时,VDA 会使用 Broker 验证 ICA 文件中的启动票证。可能的原因:ICA 文件已损坏或用户正在尝试进行未经授权的连接。 验证用户是否根据交付组中定义的用户组拥有对应用程序或桌面的访问权限。指示用户重新启动应用程序或桌面,以确定这是否是偶发问题。如果问题再次发生,请检查客户端设备事件日志以查找错误。验证用户尝试连接的 VDA 是否已注册。如果未注册,请检查 VDA 上的事件日志并解决任何注册问题。
[1] 客户端连接失败 [7] 其他 客户端最初联系 VDA 后但在完成连接序列之前,会话已从 VDA 报告为已终止。 验证会话是否在启动前未被用户终止。尝试重新启动会话,如果问题仍然存在,请收集 CDF 日志并联系 Citrix 支持。
[1] 客户端连接失败 [8] 一般故障 会话启动失败。可能的原因:在 Broker 仍在启动或初始化时请求了代理启动,或者在启动的代理阶段发生内部错误。 验证 Citrix Broker Service 正在运行并重试启动会话。
[5] 配置 [9] 维护模式 VDA 或 VDA 所属的交付组已设置为维护模式。 确定是否需要维护模式。如果不需要,请在相关交付组或计算机上禁用维护模式,并指示用户尝试重新连接。
[5] 配置 [10] 应用程序已禁用 最终用户无法访问该应用程序,因为它已被管理员禁用。 如果应用程序旨在用于生产环境,请启用该应用程序并指示用户重新连接。
[4] 无可用许可证 [11] 许可证功能被拒绝 正在使用的功能不在现有许可证的涵盖范围内。 请联系 Citrix 销售代表,确认现有 Citrix Virtual Apps and Desktops™ 许可证版本和类型所涵盖的功能。
[3] 无可用容量 [13] 会话限制已达到 所有 VDA 都在使用中,没有容量来托管更多会话。可能的原因:所有 VDA 都在使用中(对于单会话操作系统 VDA),或者所有 VDA 都已达到配置的最大并发会话数(对于多会话操作系统 VDA)。 检查是否有任何 VDA 处于维护模式。如果不需要,请禁用维护模式以释放更多容量。考虑增加 Citrix 策略设置中最大会话数的值,以允许每个服务器 VDA 承载更多会话。考虑添加更多多会话操作系统 VDA。考虑添加更多单会话操作系统 VDA。
[5] 配置 [14] 不允许的协议 ICA 和 RDP 协议不允许使用。 在交付控制器上运行 Get-BrokerAccessPolicyRule PowerShell 命令,并验证 AllowedProtocols 值是否列出了所有所需的协议。仅当存在配置错误时才会出现此问题。
[5] 配置 [15] 资源不可用 用户尝试连接的应用程序或桌面不可用。此应用程序或桌面可能不存在,或者没有可用的 VDA 来运行它。可能的原因:应用程序或桌面已取消发布,或者托管应用程序或桌面的 VDA 已达到最大负载,或者应用程序或桌面设置为维护模式。 验证应用程序或桌面是否仍已发布,并且 VDA 未处于维护模式。确定多会话操作系统 VDA 是否已满载。如果是,请预配更多多会话操作系统 VDA。验证是否有可用于连接的单会话操作系统 VDA。如有必要,请预配更多单会话操作系统 VDA。
[5] 配置 [16] 活动会话重新连接已禁用 ICA 会话处于活动状态并连接到不同的端点。但是,由于禁用了 Active Session Reconnection,客户端无法连接到活动会话。 On the delivery controller, verify that Active Session Reconnection is enabled. Verify that the value of DisableActiveSessionReconnect in the registry, under HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server is set to 0.
[2] 计算机故障 [17] 没有要重新连接的会话 客户端尝试重新连接到特定会话,但该会话已终止。 重试工作区控制重新连接。
[2] 机器故障 [18] 启动失败 VDA 无法启动会话。这是管理程序报告的问题。 如果计算机仍处于关机状态,请尝试从 Citrix Studio 启动计算机。如果失败,请检查管理程序连接和权限。如果 VDA 是 PVS 预配的计算机,请在 PVS 控制台中验证计算机是否正在运行。如果没有,请验证是否为计算机分配了个人虚拟磁盘,然后登录到管理程序以重置 VM。
[2] 机器故障 [19] 拒绝 交付控制器向 VDA 发送请求,以准备来自最终用户的连接,但 VDA 主动拒绝此请求。 通过 ping 验证交付控制器和 VDA 是否可以成功通信。如果不能,请解决任何防火墙或网络路由问题。
[2] 机器故障 [20] 配置集故障 交付控制器在会话启动期间未将所需的配置数据(例如策略设置和会话信息)发送到 VDA。可能的原因:控制器和 VDA 之间的通信问题、Broker Service 在创建配置集请求时遇到的问题,或者导致 VDA 不接受请求的网络问题。 -
[3] 无可用容量 [21] 超出最大实例总数 已达到应用程序的最大实例数。无法在 VDA 上打开应用程序的其他实例。此问题与应用程序限制功能有关。 如果许可允许,请考虑将应用程序设置“同时运行的实例数限制”提高到更高的值。
[3] 无可用容量 [22] 超出每个用户的最大实例数 用户正在尝试启动应用程序的多个实例,但该应用程序的配置只允许每个用户运行一个应用程序实例。此问题与应用程序限制功能有关。 默认情况下,每个用户只允许一个应用程序实例。如果需要每个用户多个实例,请考虑清除应用程序设置中的“限制每个用户一个实例”设置。
[1] 客户端连接失败 [23] 通信错误 交付控制器尝试向 VDA 发送信息(例如准备连接的请求),但在通信尝试期间发生错误。这可能是由网络中断引起的。 如果已启动,请重新启动 VDA 上的 Desktop 服务以重新启动注册过程并验证 VDA 是否成功注册。通过应用程序事件日志中的详细信息确认为 VDA 配置的交付控制器是准确的。
[3] 无可用容量 [100] 无可用计算机 监控服务将 [12] 无可用桌面 转换为此错误代码。 分配用于启动会话的 VDA 处于无效状态或不可用。可能的原因:VDA 的电源状态未知或不可用,VDA 自上次用户会话以来未重新启动,会话共享已禁用而当前会话需要启用它,或者 VDA 已从交付组或站点中删除。 验证 VDA 是否在交付组中。如果不在,请将其添加到相应的交付组。验证是否有足够的 VDA 已注册并处于就绪状态,以便能够启动用户请求的已发布共享桌面或应用程序。验证托管 VDA 的管理程序未处于维护模式。
[2] 计算机故障 [101] 计算机无法正常运行。 监控服务将 [12] 无可用桌面 转换为此错误代码。 VDA 未运行。可能的原因:VDA 已从交付组中移除、VDA 未注册、VDA 电源状态不可用,或者 VDA 遇到内部问题。 验证 VDA 是否在交付组中。如果不在,请将其添加到相应的交付组。验证 VDA 在 Citrix Studio 中显示为已开机。如果多台计算机的电源状态未知,请解决与虚拟机管理程序连接或主机故障相关的任何问题。验证托管 VDA 的虚拟机管理程序未处于维护模式。解决这些问题后,重新启动 VDA。

计算机故障类型

错误代码 错误代码 ID 问题 操作
未知 - - -
未注册 3 - -
最大容量(在 Director 中显示为最大负载) 4 计算机报告其已达到最大容量,即最大负载指数 确保所有管理程序均已开机。通过增加管理程序的容量或添加更多管理程序,向受影响的交付组添加更多计算机。
启动停滞 2 VM 未完成其启动序列,并且未与管理程序通信。 确保 VM 在管理程序上成功启动。检查 VM 上的其他消息,例如操作系统问题。确保管理程序工具已安装在 VM 上。确保 VDA 已安装在 VM 上。
启动失败 1 VM 在尝试在管理程序上启动时遇到问题。 检查管理程序日志。
0 - -

计算机注销原因(适用于故障类型为“未注册”或“未知”的情况)

错误代码 错误代码 ID 问题 操作
代理关机 0 VDA 经历了正常关机。 如果您不希望 VDA 根据现有电源管理策略处于关闭状态,请启动 VDA。检查事件日志中的任何错误。
代理已暂停 1 VDA 处于休眠或睡眠模式。 使 VDA 退出休眠模式。建议考虑通过电源设置禁用 Citrix Virtual Apps and Desktops VDA 的休眠功能。
版本不兼容 100 VDA 无法与交付控制器通信,原因是 Citrix 协议版本不匹配。 统一 VDA 和交付控制器的版本。
代理地址解析失败 101 交付控制器无法解析 VDA 的 IP 地址。 验证 VDA 计算机帐户是否存在于 AD 中。如果不存在,请创建它。验证 DNS 中 VDA 的名称和 IP 地址是否准确。如果不准确,请更正。如果问题普遍存在,请验证交付控制器上的 DNS 设置。通过运行 nslookup 命令验证控制器上的 DNS 解析。
101 交付控制器无法解析 VDA 的 IP 地址。 验证 VDA 计算机帐户是否存在于 AD 中。如果不存在,请创建它。验证 DNS 中 VDA 的名称和 IP 地址是否准确。如果不准确,请更正。
代理无法联系 102 交付控制器与 VDA 之间发生通信问题。 使用 ping 命令验证交付控制器和 VDA 是否可以成功通信。如果不能,请解决任何防火墙或网络问题。请参阅知识中心文章 Citrix Virtual Apps and Desktops 中 Virtual Delivery Agent 与交付控制器注册故障排除 (CTX136668) 中列出的故障排除步骤,以解决导致控制器与 VDA 之间通信问题的常见问题。
102 交付控制器与 VDA 之间发生通信问题。 请参阅知识中心文章 解决 Citrix Virtual Apps and Desktops 中 Virtual Delivery Agent 与交付控制器注册问题 (CTX136668) 中列出的故障排除步骤,了解导致控制器与 VDA 之间通信问题的常见问题。请联系 Citrix 支持。
代理活动目录OU错误 103 发生 Active Directory 发现配置错误。在 VDA 注册表中配置的特定于站点的 OU(站点控制器信息存储在 AD 中)适用于不同的站点。 确保 Active Directory 配置正确,或检查注册表设置。
注册请求为空 104 从 VDA 发送到交付控制器的注册请求为空。这可能是由于 VDA 软件安装损坏。 在 VDA 上重新启动 Desktop 服务以重新启动注册过程,并通过应用程序事件日志验证 VDA 是否正确注册。
缺少注册所需的功能 105 VDA 版本与交付控制器不兼容。 升级 VDA 或移除 VDA,然后重新安装。
缺少代理版本 106 VDA 版本与交付控制器不兼容。 如果此问题影响所有计算机,请重新安装 VDA 软件。
注册功能不一致或存在冲突 107 VDA 无法将其功能告知 Broker。这可能是由于 VDA 与交付控制器版本不兼容所致。注册功能随每个版本而变化,其表达形式与注册请求不匹配。 使 VDA 和交付控制器版本保持一致。
未获得功能许可 108 您尝试使用的功能未获得许可。 检查您的 Citrix 许可版本,或移除 VDA,然后重新安装。
108 您尝试使用的功能未获得许可。 请联系 Citrix 支持。
不支持的凭据安全版本 109 VDA 和交付控制器未采用相同的加密机制。 统一 VDA 和交付控制器版本。
无效的注册请求 110 VDA 向 Broker 发出了注册请求,但请求内容已损坏或无效。 有关导致控制器与 VDA 之间通信问题的常见问题,请参阅知识中心文章 解决 Citrix Virtual Apps and Desktops 中 VDA 与交付控制器注册问题 (CTX136668) 中列出的故障排除步骤。
单会话多会话不匹配 111 VDA 的操作系统类型与计算机目录或交付组不兼容。 将 VDA 添加到正确的计算机目录类型或包含相同操作系统的计算机的交付组。
目录功能级别过低 112 计算机目录设置的 VDA 功能级别高于已安装的 VDA 版本。 验证 VDA 的计算机目录功能级别是否与 VDA 的功能级别匹配。升级或降级计算机目录以使其与 VDA 匹配。
桌面组功能级别过低 113 交付组设置的 VDA 功能级别高于已安装的 VDA 版本。 验证 VDA 的交付组功能级别是否与 VDA 的功能级别匹配。升级或降级计算机目录以使其与 VDA 匹配。
关机 200 VDA 未正常关机。 如果 VDA 应该处于开机状态,请尝试从 Citrix Studio 启动 VDA,并验证其是否正常启动和注册。排查任何启动或注册问题。VDA 重新启动后,查看其事件日志以帮助确定关机的根本原因。
代理拒绝设置更新 203 Citrix 策略等设置已更改或更新,但在将更新发送到 VDA 时出错。如果更新与已安装的 VDA 版本不兼容,则可能会发生这种情况。 如有必要,请升级 VDA。检查所应用的更新是否与 VDA 版本兼容。
会话准备失败 206 代理未完成对 VDA 上运行的会话的审计。 如果普遍存在,请在交付控制器上重新启动 Citrix Broker 服务。
206 代理未完成对 VDA 上运行的会话的审计。 联系 Citrix 支持。
连接丢失 207 交付控制器与 VDA 失去连接。这可能是由网络中断引起的。 验证 Citrix Broker 服务正在交付控制器上运行,并且 Desktop 服务正在 VDA 上运行。如果已停止,则启动每个服务。如果已启动,请重新启动 VDA 上的 Desktop 服务以重新启动注册过程,并验证 VDA 是否成功注册。通过应用程序事件日志中的详细信息,确认为 VDA 配置的交付控制器是准确的。使用 ping 命令验证交付控制器和 VDA 是否可以成功通信。如果不能,请解决任何防火墙或网络问题。
207 交付控制器与 VDA 失去连接。这可能是由网络中断引起的。 验证 Desktop 服务是否在 VDA 上运行。如果已停止,则启动。
代理注册达到限制 301 交付控制器已达到允许同时注册的 VDA 的最大配置数量。默认情况下,交付控制器允许 10,000 个并发 VDA 注册。 考虑将交付控制器添加到站点或创建站点。您还可以通过 HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers 注册表项增加允许同时注册到交付控制器的 VDA 数量。有关详细信息,请参阅知识中心文章 Registry Key Entries Used by Citrix Virtual Apps and Desktops (CTX117446)。增加此数量可能需要控制器更多的 CPU 和内存资源。
设置创建失败 208 Broker 未构建要发送到 VDA 的设置和配置集。如果 Broker 无法收集数据,则注册失败,VDA 将变为未注册状态。 检查交付控制器上的事件日志是否存在任何错误。如果日志中没有明显的特定问题,请重新启动 Broker Service。Broker Service 重新启动后,重新启动受影响 VDA 上的 Desktop 服务,并验证它们是否成功注册。
208 Broker 未构建要发送到 VDA 的设置和配置集。如果 Broker 无法收集数据,则注册失败,VDA 将变为未注册状态。 重新启动受影响 VDA 上的 Desktop 服务,并验证它们是否成功注册。联系 Citrix 支持。
发送设置失败 204 Broker 未将设置和配置数据发送到 VDA。如果 Broker 可以收集数据但无法发送,则注册失败。 如果仅限于单个 VDA,请重新启动 VDA 上的 Desktop 服务以强制重新注册,并通过应用程序事件日志验证 VDA 是否成功注册。解决发现的任何错误。有关导致控制器和 VDA 之间通信问题的常见问题,请参阅知识中心文章 Troubleshooting Virtual Delivery Agent Registration with delivery controllers in Citrix Virtual Apps and Desktops (CTX136668) 中列出的故障排除步骤。
代理请求 2 发生未知错误。 请联系 Citrix 支持。
桌面重新启动 201 发生未知错误。 请联系 Citrix 支持。
桌面已移除 202 发生未知错误。 请联系 Citrix 支持。
会话审计失败 205 发生未知错误。 联系 Citrix 支持。
未知错误 300 发生未知错误。 联系 Citrix 支持。
注册状态不匹配 302 发生未知错误。 联系 Citrix 支持。
未知 - 发生未知错误。 联系 Citrix 支持。
思杰 Director 故障原因和故障排除