Citrix Director 故障原因和故障排除

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

连接失败错误

类别 原因 问题 操作
不适用 [0] 未知。此错误代码未映射。 监视服务无法根据代理服务共享的信息确定报告的启动或连接失败的原因。 在控制器上收集 CDF 日志并联系 Citrix 技术支持。
[0] 无 [1] 无 不适用
[2] MachineFailure [2] SessionPreparation 从 Delivery Controller 向 VDA 发送的会话准备请求失败。可能的原因:Controller 和 VDA 之间的通信问题、Broker Service 在创建准备请求过程中遇到的问题,或导致 VDA 不接受请求的网络问题。 有关导致 Controller 与 VDA 之间的通信问题的常见问题,请参阅知识中心文章在 Citrix Virtual Apps and Desktops 中对 Virtual Desktop Agent 在 Delivery Controller 中的注册进行故障排除中列出的故障排除步骤。
[2] MachineFailure [3] RegistrationTimeout VDA 已打开,但尝试在 Delivery Controller 中注册时发生超时。 确认 Citrix Broker Service 是否正在 Delivery Controller 上运行,以及 Desktop Service 是否正在 VDA 上运行。如果停止,则将启动每一个。
[1] ClientConnectionFailure [4] ConnectionTimeout 准备好 VDA 以启动会话之后客户端未连接到 VDA。会话已被成功代理,但等待客户端连接到 VDA 时发生超时。可能的原因:防火墙设置、网络中断或阻止远程连接的设置。 查看 Director 控制台,了解客户端当前是否具有活动连接,这意味着所有用户都不受影响。如果不存在会话,请查看客户端和 VDA 上的事件日志中是否记录了任何错误消息。解决客户端与 VDA 之间的网络连接存在的任何问题。
[4] NoLicensesAvailable [5] 许可 许可请求失败。可能的原因:许可证数量不足或许可证服务器已关闭 30 天以上。 确认许可证服务器是否已联机且可访问。请解决与许可证服务器有关的所有网络连接问题或重新启动许可证服务器(如果可能出现故障)。确认环境中是否具有足够的许可证,并根据需要分配更多许可证。
[1] ClientConnectionFailure [6] 票据处理 创建票据期间出现故障,指出客户端与 VDA 的连接与代理的请求不匹配。启动请求票据是通过 Broker 准备的,在 ICA 文件中提供。当用户尝试启动会话时,VDA 将通过 Broker 验证 ICA 文件中的启动票据。可能的原因:ICA 文件损坏或用户正在尝试建立未经授权的连接。 根据在交付组中定义的用户组确认用户是否有权访问应用程序或桌面。指示用户重新启动应用程序或桌面以确定这是否是一次性问题。如果此问题再次出现,请查看客户端设备事件日志中记录的错误消息。验证用户正在尝试连接到的 VDA 是否已注册。如果未注册,请检查 VDA 上的事件日志并解决与注册有关的所有问题。
[1] ClientConnectionFailure [7] 其他 在客户端最初联系 VDA 之后、完成连接顺序之前已将会话报告为从 VDA 终止。 确认会话是否在启动之前被用户终止。尝试重新启动会话,如果问题仍然存在,请收集 CDF 日志并联系 Citrix 技术支持。
[1] ClientConnectionFailure [8] GeneralFail 会话无法启动。可能的原因:已请求执行代理的启动,但 Broker 仍在启动或初始化,或启动的代理阶段出现内部错误。 确认 Citrix Broker Service 是否正在运行并重新尝试启动会话。
[5] 配置 [9] MaintenanceMode VDA 或 VDA 所属的交付组是在维护模式下设置的。 确定是否需要维护模式。如果不需要,请在有问题的交付组或计算机上禁用维护模式,并指示用户尝试重新连接。
[5] 配置 [10] ApplicationDisabled 最终用户无法访问该应用程序,因为它已被管理员禁用。 如果应用程序可供生产使用,请启用该应用程序并指示用户重新连接。
[4] NoLicensesAvailable [11] LicenseFeature Refused 正在使用的功能不在现有许可证的涵盖范围内。 联系 Citrix 销售代表,确认现有 Citrix Virtual Apps and Desktops 许可证版本和类型涵盖的功能。
[3] NoCapacityAvailable [13] SessionLimitReached 所有 VDA 都在使用中,没有容量来托管更多会话。可能的原因:所有 VDA 都在使用中(针对单会话操作系统 VDA),或所有 VDA 都已达到所配置的最大允许并发会话数(针对多会话操作系统 VDA)。 确认是否存在处于维护模式的任何 VDA。如果不需要释放更多容量,请禁用维护模式。考虑增加 Citrix 策略设置中最大会话数的值,以允许每个服务器 VDA 上运行更多会话。考虑添加更多多会话操作系统 VDA。考虑添加更多单会话操作系统 VDA。
[5] 配置 [14] DisallowedProtocol 不允许使用 ICA 和 RDP 协议。 在 Delivery Controller 上运行 Get-BrokerAccessPolicyRule PowerShell 命令并验证 AllowedProtocols 值是否列出了所需的所有协议。仅当存在配置错误时才会出现此问题。
[5] 配置 [15] ResourceUnavailable 用户尝试连接的应用程序或桌面不可用。此应用程序或桌面可能不存在,或者没有可用于运行此应用程序或桌面的 VDA。可能的原因:应用程序或桌面未发布,或托管应用程序或桌面的 VDA 已达最大负载,或应用程序或桌面是在维护模式下设置的。 确认应用程序或桌面是否仍处于已发布状态,以及 VDA 是否未处于维护模式。确定多会话操作系统 VDA 是否处于满载状态。如果满载,请预配更多多会话操作系统 VDA。确认是否存在可供连接的单会话操作系统 VDA。如有需要,请预配更多单会话操作系统 VDA。
[5] 配置 [16] ActiveSessionReconnectDisabled ICA 会话处于活动状态,并且连接到不同的端点。但是,由于活动会话重新连接已禁用,因此,客户端无法连接到活动会话。 在 Delivery Controller 上,确认活动会话重新连接是否已启用。确认注册表中 HKEY_LOCAL_MACHINE\Software\Citrix\Desktop\Server 下的 DisableActiveSessionReconnect 的值是否设置为 0。
[2] MachineFailure [17] NoSessionToReconnect 客户端尝试重新连接到特定会话,但该会话已终止。 重新尝试执行工作区控制重新连接。
[2] MachineFailure [18] SpinUpFailed 无法为会话启动打开 VDA 的电源。这是虚拟机管理程序报告的问题。 如果计算机仍处于关闭状态,请尝试从 Citrix Studio 启动计算机。如果失败,请查看虚拟机管理程序的连接性和权限。如果 VDA 是 PVS 预配的计算机,请在 PVS 控制台中确认该计算机是否正在运行。如果未运行,请验证是否已为该计算机分配虚拟磁盘,然后登录虚拟机管理程序以重置 VM。
[2] MachineFailure [19] 被拒绝 Delivery Controller 向 VDA 发送了准备建立来自最终用户的连接请求,但 VDA 主动拒绝了该请求。 通过 ping 确认 Delivery Controller 是否能够成功与 VDA 通信。如果不成功,请解决所有防火墙或网络路由问题。
[2] MachineFailure [20] ConfigurationSet Failure Delivery Controller 在会话启动过程中未向 VDA 发送所需的配置数据,例如,策略设置和会话信息。可能的原因:Controller 和 VDA 之间的通信问题、创建配置设置请求时 Broker Service 遇到的问题,或导致 VDA 不接受请求的网络问题。 -
[3] NoCapacityAvailable [21] MaxTotalInstancesExceeded 已达到应用程序的实例数上限。不能在 VDA 上打开更多应用程序实例。此问题与应用程序限制功能有关。 如果许可允许,请考虑将应用程序设置将同时运行的实例数限制为增大到更大的值。
[3] NoCapacityAvailable [22] MaxPerUserInstancesExceeded 用户正在尝试打开某个应用程序的多个实例,但该应用程序配置为仅允许每个用户打开应用程序的一个实例。此问题与应用程序限制功能有关。 默认情况下,仅允许每个用户使用一个应用程序实例。如果要求每个用户运行多个实例,请考虑取消选中应用程序设置中的限制每个用户一个实例设置。
[1] ClientConnectionFailure [23] Communication error Delivery Controller 尝试向 VDA 发送信息(例如,准备建立连接请求),但通信尝试期间出现错误。此问题可能是由于网络中断导致的。 如果已启动,请在 VDA 上重新启动桌面服务以重新启动注册过程并验证 VDA 是否已成功注册。请通过应用程序事件日志中的详细信息确认为 VDA 配置的 Delivery Controller 是否准确无误。
[3] NoCapacityAvailable [100] NoMachineAvailable Monitoring service converts [12] NoDesktopAvailable to this error code. 所分配的用于启动会话的 VDA 处于无效状态或者不可用。可能的原因:VDA 的电源状态未知或不可用、VDA 自最后一个用户的会话结束之后未重新启动、会话共享已禁用,但当前会话需要启用该功能,或 VDA 已从交付组或站点中删除。 验证 VDA 是否在交付组中。如果没有,请将其添加到相应的交付组中。确认注册的 VDA 数量是否充足且处于已就绪状态,能够启动用户请求的已发布共享桌面或应用程序。确认托管 VDA 的虚拟机管理程序是否未处于维护模式。
[2] MachineFailure [101] MachineNotFunctional. Monitoring service converts [12] NoDesktopAvailable to this error code. VDA 无法运行。可能的原因:VDA 已从交付组中删除、VDA 未注册、VDA 电源状态不可用或 VDA 遇到内部问题。 验证 VDA 是否在交付组中。如果没有,请将其添加到相应的交付组中。验证 VDA 在 Citrix Studio 中是否显示为已打开电源。如果多台计算机的电源状态未知,请解决与虚拟机管理程序连接或主机故障有关的任何问题。确认托管 VDA 的虚拟机管理程序是否未处于维护模式。解决这些问题后,重新启动 VDA。

计算机故障类型

错误代码 错误代码 ID 问题 操作
未知 - - -
未注册 3 - -
最大容量(表示为 Director 上的最大负载) 4 计算机正在报告自己处于最大容量(即最大负载指数) 确保所有虚拟机管理程序都已启动。通过向虚拟机管理程序中添加更多容量或者添加更多虚拟机管理程序,将更多计算机添加到受影响的交付组。
StuckOnBoot 2 VM 未完成其启动顺序,并且不与虚拟机管理程序通信。 确保 VM 已在虚拟机管理程序上成功启动。检查 VM 上的其他消息,例如操作系统问题。确保已在 VM 上安装虚拟机管理程序工具。确保已在 VM 上安装 VDA。
FailedToStart 1 尝试在虚拟机管理程序上启动时 VM 遇到问题。 查看虚拟机管理程序日志。
0 - -

计算机取消注册原因(故障类型为“未注册”或“未知”时适用)

错误代码 错误代码 ID 问题 操作
AgentShutdown 0 VDA 出现正常关机。 如果根据现有的电源管理策略,您不希望 VDA 关闭,请打开 VDA 的电源。查看事件日志中记录的任何错误。
AgentSuspended 1 VDA 处于休眠或睡眠模式。 使 VDA 退出休眠模式。考虑通过电源设置对 Citrix Virtual Apps and Desktops VDA 禁用休眠。
IncompatibleVersion 100 由于 Citrix 协议版本不匹配,VDA 无法与 Delivery Controller 通信。 调整 VDA 与 Delivery Controller 的版本,使其保持一致。
AgentAddressResolutionFailed 101 Delivery Controller 无法解析 VDA 的 IP 地址。 验证 AD 中是否存在 VDA 计算机帐户。如果没有,请创建。验证 DNS 中 VDA 的名称和 IP 地址是否准确。如果没有,请纠正。如果普遍存在,请验证 Delivery Controller 上的 DNS。通过运行 nslookup 命令从 Controller 验证 DNS 解析。
101 Delivery Controller 无法解析 VDA 的 IP 地址。 验证 AD 中是否存在 VDA 计算机帐户。如果没有,请创建。验证 DNS 中 VDA 的名称和 IP 地址是否准确。如果没有,请纠正。
AgentNotContactable 102 Delivery Controller 与 VDA 之间出现通信问题。 使用 ping 验证 Delivery Controller 是否可以与 VDA 成功通信。如果没有,请解决任何防火墙或网络问题。有关导致 Controller 与 VDA 之间的通信问题的常见问题,请参阅知识中心文章在 Citrix Virtual Apps and Desktops 中对 Virtual Desktop Agent 在 Delivery Controller 中的注册进行故障排除 (CTX136668) 中列出的故障排除步骤。
102 Delivery Controller 与 VDA 之间出现通信问题。 有关导致 Controller 与 VDA 之间的通信问题的常见问题,请参阅知识中心文章在 Citrix Virtual Apps and Desktops 中对 Virtual Desktop Agent 在 Delivery Controller 中的注册进行故障排除 (CTX136668) 中列出的故障排除步骤。联系 Citrix 技术支持。
AgentWrongActiveDirectoryOU 103 发生了 Active Directory 发现错误配置。在 VDA 注册表中配置的站点特定的 OU (其中,站点控制器信息存储在 AD 中)适用于不同的站点。 确保 Active Directory 配置正确无误,或者检查注册表设置。
EmptyRegistrationRequest 104 从 VDA 发送到 Delivery Controller 的注册请求为空。这可能是由于损坏的 VDA 软件安装导致的。 重新启动 VDA 上的 Desktop Service 以重新启动注册过程,并通过应用程序事件日志确认 VDA 是否已正确注册。
MissingRegistrationCapabilities 105 VDA 版本与 Delivery Controller 不兼容。 升级 VDA,或者删除 VDA 并重新安装。
MissingAgentVersion 106 VDA 版本与 Delivery Controller 不兼容。 如果此问题影响所有计算机,请重新安装 VDA 软件。
InconsistentRegistrationCapabilities 107 VDA 无法向 Broker 传达自己的功能。这可能是由于 VDA 与 Delivery Controller 版本之间的不兼容导致的。注册功能(因版本而异)是使用与注册请求不匹配的格式表示的。 调整 VDA 与 Delivery Controller 的版本,使其保持一致。
NotLicensedForFeature 108 您正在尝试使用的功能未获许可。 检查您的 Citrix Licensing 版本,或者删除 VDA 并重新安装。
108 您正在尝试使用的功能未获许可。 联系 Citrix 技术支持。
UnsupportedCredentialSecurity 版本 109 VDA 与 Delivery Controller 使用的加密机制不同。 调整 VDA 与 Delivery Controller 的版本,使其保持一致。
InvalidRegistrationRequest 110 VDA 向 Broker 发出了注册请求,但请求的内容已损坏或无效。 有关导致 Controller 与 VDA 之间的通信问题的常见问题,请参阅知识中心文章在 Citrix Virtual Apps and Desktops 中对 Virtual Desktop Agent 在 Delivery Controller 中的注册进行故障排除 (CTX136668) 中列出的故障排除步骤。
SingleMultiSessionMismatch 111 VDA 的操作系统类型与计算机目录或交付组不兼容。 将 VDA 添加到正确的计算机目录类型或包含安装了相同操作系统的计算机的交付组。
FunctionalLevelTooLowForCatalog 112 为计算机目录设置的 VDA 功能级别高于所安装的 VDA 版本。 确认 VDA 的计算机目录功能级别是否与 VDA 的功能级别匹配。升级或降级计算机目录以匹配 VDA 的计算机目录。
FunctionalLevelTooLowForDesktopGroup 113 为交付组设置的 VDA 功能级别高于所安装的 VDA 版本。 确认 VDA 的交付组功能级别是否与 VDA 的功能级别匹配。升级或降级计算机目录以匹配 VDA 的计算机目录。
PowerOff 200 VDA 未正常关闭。 如果假定 VDA 已启动,请尝试从 Citrix Studio 中启动 VDA,并验证其是否能够正确启动并注册。任何启动或注册问题故障排除。备份后检查 VDA 上的事件日志,以帮助确定关闭的根本原因。
AgentRejectedSettingsUpdate 203 已更改或更新 Citrix 策略等设置,但向 VDA 发送更新时出错。如果更新与所安装的 VDA 版本不兼容,则可能会出现此问题。 根据需要升级 VDA。检查 VDA 版本是否支持应用的更新。
SessionPrepareFailure 206 Broker 未完成 VDA 上正在运行的会话的审核。 如果普遍存在,请重新启动 Delivery Controller 上的 Citrix Broker Service。
206 Broker 未完成 VDA 上正在运行的会话的审核。 联系 Citrix 技术支持。
ContactLost 207 Delivery Controller 与 VDA 断开连接。这可能是由网络中断造成的。 确认 Citrix Broker Service 是否正在 Delivery Controller 上运行,以及 Desktop Service 是否正在 VDA 上运行。如果停止,则将启动每一个。如果已启动,请在 VDA 上重新启动桌面服务以重新启动注册过程并验证 VDA 是否已成功注册。请通过应用程序事件日志中的详细信息确认为 VDA 配置的 Delivery Controller 是否准确无误。使用 ping 验证 Delivery Controller 是否可以与 VDA 成功通信。如果没有,请解决任何防火墙或网络问题。
207 Delivery Controller 与 VDA 断开连接。这可能是由网络中断造成的。 验证 Desktop Service 是否正在 VDA 上运行。如果已停止,请启动。
BrokerRegistrationLimitReached 301 Delivery Controller 已达到允许所配置的 VDA 同时在其中注册的最大数量。默认情况下,Delivery Controller 允许 10000 个并发 VDA 注册。 考虑向站点中添加 Delivery Controller 或者创建一个新站点。还可以通过 HKEY_LOCAL_MACHINE\Software\Citrix\DesktopServer\MaxWorkers 注册表项增加允许在 Delivery Controller 中同时注册的 VDA 数量。有关详细信息,请参阅知识中心文章 Citrix Virtual Apps and Desktops 使用的注册表项 (CTX117446)。对于 Controller 而言,增加此数字可能需要更多的 CPU 和内存资源。
SettingsCreationFailure 208 Broker 未构建一组要发送到 VDA 的设置和配置。如果 Broker 无法收集数据,注册将失败,VDA 将取消注册。 检查 Delivery Controller 上的事件日志中是否记录了任何错误。如果日志中未明确记录某个特定问题,请重新启动 Broker Service。重新启动 Broker Service 后,重新启动受影响的 VDA 上的 Desktop Service,并确认这些 VDA 是否已成功注册。
208 Broker 未构建一组要发送到 VDA 的设置和配置。如果 Broker 无法收集数据,注册将失败,VDA 将取消注册。 重新启动受影响的 VDA 上的 Desktop Service,并确认这些 VDA 是否已成功注册。联系 Citrix 技术支持。
SendSettingsFailure 204 Broker 未向 VDA 发送设置和配置数据。如果 Broker 能够收集但无法发送数据,注册将失败。 如果限制到单个 VDA,请重新启动 VDA 上的 Desktop Service 以强制重新注册,并通过应用程序事件日志验证 VDA 是否已成功注册。请解决发现的所有错误。有关导致 Controller 与 VDA 之间的通信问题的常见问题,请参阅知识中心文章在 Citrix Virtual Apps and Desktops 中对 Virtual Desktop Agent 在 Delivery Controller 中的注册进行故障排除 (CTX136668) 中列出的故障排除步骤。
AgentRequested 2 出现未知错误。 联系 Citrix 技术支持。
DesktopRestart 201 出现未知错误。 联系 Citrix 技术支持。
DesktopRemoved 202 出现未知错误。 联系 Citrix 技术支持。
SessionAuditFailure 205 出现未知错误。 联系 Citrix 技术支持。
UnknownError 300 出现未知错误。 联系 Citrix 技术支持。
RegistrationStateMismatch 302 出现未知错误。 联系 Citrix 技术支持。
未知 - 出现未知错误。 联系 Citrix 技术支持。
Citrix Director 故障原因和故障排除