Citrix控制器故障原因及排除

下表描述了各种故障类别、原因和解决问题所需采取的行动。有关更多信息,请参见枚举、错误代码和说明

连接失败的错误

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

机器故障类型

错误代码 错误代码标识 问题 行动
未知的 - - -
未注册的 3. - -
MaxCapacity 4 hypervisor上的负载索引处于最大容量。 确保所有虚拟化环境都已上电。增加系统管理程序的容量。添加更多的虚拟机监控程序。
StuckOnBoot 2 虚拟机没有完成引导顺序,没有与hypervisor通信。 请确保虚拟机在虚拟化环境中启动成功。检查虚拟机是否有其他消息,如操作系统问题。请确保虚拟机已安装虚拟化环境的工具。确保虚拟机已安装VDA。
FailedToStart 1 当尝试在hypervisor上启动时,VM遇到了问题。 检查虚拟机监控程序日志。
没有一个 0 - -

机器注销原因(适用于故障类型为未注册或未知)

错误代码 错误代码标识 问题 行动
AgentShutdown 0 VDA经历了一个优雅的关机。 如果您不希望根据现有的电源管理策略关闭VDA,请将其上电。检查事件日志中的任何错误。
AgentSuspended 1 VDA处于休眠或休眠状态。 将VDA从休眠模式中取出。考虑通过电源设置禁用Citrix虚拟应用程序和桌面VDAs的休眠。
IncompatibleVersion 100 由于Citrix协议版本不匹配,VDA无法与下发控制器通信。 调整VDA和交付控制器版本。
AgentAddressResolutionFailed 101 交付控制器无法解析VDA的IP地址。 检查AD中是否存在VDA机器帐号。如果没有,就创建它。检查DNS中VDA的名称和IP地址是否正确。如果不是,纠正它们。如果广泛使用,请验证传递控制器上的DNS设置。通过运行控制器来验证DNS解析网路资讯查询命令。
(云):AgentAddressResolutionFailed 101 交付控制器无法解析VDA的IP地址。 检查AD中是否存在VDA机器帐号。如果没有,就创建它。检查DNS中VDA的名称和IP地址是否正确。如果不是,纠正它们。
AgentNotContactable 102 交付控制器和VDA之间发生通信问题。 使用ping来验证传递控制器和VDA能够成功通信。如果没有,解决任何防火墙或网络问题。请参阅Knowledge Center文章中列出的故障排除步骤,Citrix虚拟应用程序和桌面系统中虚拟交付代理与交付控制器的注册故障排除(CTX136668),用于解决导致控制器和VDA之间通信问题的常见问题。
(云):AgentNotContactable 102 交付控制器和VDA之间发生通信问题。 请参阅Knowledge Center文章中列出的故障排除步骤,Citrix虚拟应用程序和桌面系统中虚拟交付代理与交付控制器的注册故障排除(CTX136668),用于解决导致控制器和VDA之间通信问题的常见问题。接触Citrix的支持。
AgentWrongActiveDirectoryOU 103 发生了activedirectory发现错误配置。VDA注册表中配置的特定于站点的OU(站点控制器信息存储在AD中)用于不同的站点。 确保活动目录配置正确,或检查注册表设置。
EmptyRegistrationRequest 104 从VDA发送到传递控制器的注册请求为空。这可能是由于VDA软件安装损坏所致。 重新启动VDA上的Desktop服务,以重新启动注册过程,并通过应用程序事件日志验证VDA正确注册。
MissingRegistrationCapabilities 105 VDA版本与下发控制器不兼容。处理步骤 升级VDA或移除VDA后重新安装。
MissingAgentVersion 106 VDA版本与下发控制器不兼容。处理步骤 如果问题影响到所有机器,请重新安装VDA软件。
InconsistentRegistrationCapabilities 107 VDA无法将其功能传递给Broker。这可能是由于VDA和交付控制器版本之间的不兼容。注册功能会随着版本的不同而变化,但其表示形式与注册请求不匹配。 调整VDA和交付控制器版本。
NotLicensedForFeature 108 您试图使用的功能未获得许可。 检查您的Citrix许可版本,或删除VDA,然后重新安装它。
(云):NotLicensedForFeature 108 您试图使用的功能未获得许可。 接触Citrix的支持。
UnsupportedCredentialSecurity版本 109 VDA和交付控制器没有使用相同的加密机制。 调整VDA和交付控制器版本。
InvalidRegistrationRequest 110 VDA向代理发出注册请求,但请求的内容已损坏或无效。 请参阅Knowledge Center文章中列出的故障排除步骤,Citrix虚拟应用程序和桌面系统中虚拟交付代理与交付控制器的注册故障排除(CTX136668),用于解决导致控制器和VDA之间通信问题的常见问题。
单多段失配 111 VDA的操作系统类型与机器目录或交付组不兼容。 将VDA添加到包含具有相同操作系统的计算机的正确计算机目录类型或交付组中。
FunctionalLevel工具用于目录 112 机器目录被设置为比安装的VDA版本更高的VDA功能级别。 验证VDA的机器目录功能级别是否与VDA的匹配。升级或降级机器目录以匹配VDA的目录。
FunctionalLevelTooLowForDesktopGroup 113 交付组设置的VDA功能级别高于实际安装的VDA版本。 验证VDA的交付组功能级别与VDA的匹配。升级或降级计算机目录以匹配VDA的目录。
定时关机 200 VDA并没有优雅地关闭。 如果VDA应该通电,请尝试从Citrix Studio启动VDA,并验证它是否正确启动和注册。对任何引导或注册问题进行故障排除。一旦VDA备份,请查看VDA上的事件日志,以帮助确定停机的根本原因。
AgentRejectedSettingsUpdate 203 Citrix策略等设置已更改或更新,但向VDA发送更新时出错。如果更新与已安装的VDA版本不兼容,则可能发生这种情况。 如有必要,升级VDA。查看VDA版本是否支持应用的更新。
会议准备 206 代理没有完成对在VDA上运行的会话的审计。 如果广泛使用,请在交付控制器上重启Citrix Broker Service。
(云):SessionPrepareFailure 206 代理没有完成对在VDA上运行的会话的审计。 接触Citrix的支持。
ContactLost 207 交付控制器与VDA失去连接。这可能是由网络中断引起的。 验证交付控制器上是否运行Citrix Broker服务,VDA上是否运行Desktop服务。如果停止了,就重新开始。如果已经启动,请重新启动VDA的Desktop服务,重新启动注册过程,验证VDA注册成功。通过Application事件日志中的详细信息,确认为VDA配置的交付控制器是准确的。使用ping来验证传递控制器和VDA能够成功通信。如果没有,解决任何防火墙或网络问题。
[云]:联系人丢失 207 交付控制器与VDA失去连接。这可能是由网络中断引起的。 检查VDA上是否运行Desktop服务。如果停止了。
BrokerRegistrationLimitReached 301 交付控制器已达到所配置的允许并发注册的VDAs的最大数量。默认情况下,交付控制器允许10,000个并发VDA注册。 考虑将递送控制器添加到站点或创建站点。您还可以通过增加允许同时向交付控制器注册的VDA数量HKEY_LOCAL_MACHINE \ Software \ Citrix \ DesktopServer \ MaxWorkers注册表键。参见知识中心文章,Citrix虚拟应用程序和桌面使用的注册表项(CTX117446)为更多的信息。增加这个数字可能需要更多的CPU和内存资源用于控制器。
SettingsCreationFailure 208 Broker没有构造一组要发送到VDA的设置和配置。如果代理无法收集数据,则注册失败,VDA变成未注册。 检查传递控制器上的事件日志是否有任何错误。如果日志中没有明显的特定问题,则重新启动Broker Service。重新启动代理服务后,在受影响的VDAs上重新启动Desktop服务,并检查它们是否成功注册。
(云):SettingsCreationFailure 208 Broker没有构造一组要发送到VDA的设置和配置。如果代理无法收集数据,则注册失败,VDA变成未注册。 在受影响的VDA上重新启动桌面服务,并验证它们是否成功注册。联系Citrix支持。
SendSettingsFailure 204 代理没有向VDA发送设置和配置数据。如果代理可以收集数据,但无法发送数据,则注册失败。 如果仅限于单个VDA,则重新启动VDA上的Desktop服务,以强制重新注册,并通过应用程序事件日志验证VDA是否成功注册。排除任何看到的错误。请参阅知识中心文章中列出的故障排除步骤,Citrix虚拟应用程序和桌面系统中虚拟交付代理与交付控制器的注册故障排除(CTX136668),用于解决导致控制器和VDA之间通信问题的常见问题。
AgentRequested 2 发生未知错误。 接触Citrix的支持。
DesktopRestart 201 发生未知错误。 接触Citrix的支持。
DesktopRemoved 202 发生未知错误。 接触Citrix的支持。
SessionAuditFailure 205 发生未知错误。 接触Citrix的支持。
UnknownError 300 发生未知错误。 接触Citrix的支持。
RegistrationStateMismatch 302 发生未知错误。 接触Citrix的支持。
未知的 - 发生未知错误。 接触Citrix的支持。
Citrix控制器故障原因及排除