Citrix Application Delivery Management 服务

使用诊断工具或 ADM GUI 对问题进行故障排除

注意

该诊断工具仅适用于使用基于 Citrix ADM 连接的低接触入门方式载入或将要载入的 ADC 实例。

有关更多信息,请参阅 使用 Citrix ADM 连接对 Citrix ADC 实例进行低接触式启动

将 ADC 实例加载到 Citrix ADM 上时,您可能会遇到一些阻止 ADC 实例成功加载的问题。作为管理员,您必须知道入职失败的原因。在以下情况下,您可以使用诊断工具执行诊断检查:

  • 在自动入职或基于脚本的入职过程中遇到任何问题

  • 想要确保 ADC 实例是否已准备就绪

  • 想要分析在 Citrix ADM GUI 中显示“关闭”状态的已载入 ADC 实例的问题

如果在 ADC 实例上启用了 AD M 服务连接 ,则诊断详细信息将自动发送到 Citrix,您可以在 ADM GUI中查看详细信息。如果未启用 ADM 服务连接,则可以 手动使用诊断工具

手动使用诊断工具

诊断工具作为 mastools 升级(13.1-2.x 或更高版本)的一部分提供,可通过以下 URL 访问:/var/mastools/scripts。您可以通过在 ADC 实例中运行 cat /var/mastools/version.txt 命令来验证 mastools 版本。

要运行诊断工具,请执行以下操作:

  1. 使用 SSH 客户端登录 ADC 实例。

  2. 键入 shell 并按 Enter 键切换到 bash 模式。

  3. 键入 cd /var/mastools/scripts

  4. 键入 sh mastools_diag

该工具启动并显示以下诊断检查的结果:

  • nscli

  • DNS 配置

  • 互联网连接

  • 实例到 ADM 的连接

  • 用户特权

如果故障排除后问题仍然存在,则可以联系 Citrix 支持人员。联系 Citrix 支持人员时,必须提供运行诊断工具后显示的 ADM 连接配置信息。

以下是没有问题的 ADC 实例的诊断结果示例:

无问题 ADC 实例的诊断结果

  • 1 — 显示诊断检查的类型

  • 2 — 以绿色或红色显示诊断检查结果。绿色表示结果成功,红色表示结果不成功。

  • 3 -每次运行诊断工具时,以黄色显示 Citrix ADM 配置信息。如果要联系 Citrix 支持人员,则必须提供此信息。

使用诊断工具验证 ADC 实例是否准备就绪

在将 ADC 实例载入 Citrix ADM 之前,您可以通过在 ADC 实例上运行诊断工具来检查 ADC 实例的准备情况。如果 ADC 实例没有问题且已准备就绪,则该工具会 在 ADM 消息中显示未声明的设备

Citrix ADM 上未申领设备

在 ADM GUI 中查看 ADC 诊断信息

导航到 基础结构 > 实例 > Citrix ADC ,然后单击“资产清单”以查看新添加的“入门准备就绪”选项,该选项提供 ADC 实例的入门准备状态,例如“需要审查”或“确定”

  • 需要审查。ADC 实例存在需要修复的问题。

  • 好吧。ADC 实例已准备就绪,可以上线。

注意

如果“入门就绪”显示为空白,则表示 ADC 实例未使用支持诊断的最新映像运行。

如果 ADC 实例有任何问题,则会出现“需要审查”选项,您可以单击查看更多详细信息。

自动诊断消息

单击“需要审查”后, ADC 诊断详细信息 页面将显示问题详细信息。

自动诊断问题详情

  • Category(类别)。提供问题类别。

  • 状态。提供问题状态,例如“需要审查”、“确定”或“不适用”。

  • 建议。提供解决问题所需的建议。

修复问题后,“入职准备就绪”中的状态更改为“正常”

故障排除

以下是一些 ADC 实例问题及其故障排除步骤:

用户名或密码无效

凭证无效

解决方法:确保管理员配置文件中提供的用户名和密码正确无误。如果您修改了 ADC 实例密码,则必须修改实例的管理员配置文件。有关更多信息,请参阅 修改管理员配置文件

DNS 配置错误

DNS 配置错误

解决方法:确保 DNS 已配置或者 DNS IP 地址有效。有关更多信息,请参阅 DNS 配置

没有互联网连接

解决方法:确保防火墙设置没有阻止 Internet 访问,并且配置了所需的代理。

无法连接到 Citrix ADM 端点

解决方法:确保检查防火墙设置,防火墙中未阻止以下 Citrix ADM 端点:

ADM_GRP_EP = "adm.cloud.com"

ADM_AGENT_EP = "agent.adm.cloud.com"

ADM_TRUST_EP = "trust.citrixnetworkapi.net"

ADM_DOWNLOAD_EP = "download.citrixnetworkapi.net"
<!--NeedCopy-->

如果在诊断检查中未发现问题且无连接问题仍然存在,请记下 Citrix ADM 配置信息(以黄色显示)并联系 Citrix 支持人员。

当您执行测试运行以确保 ADC 实例已准备就绪时,可能会出现以下问题:

内置代理试运行超时

如果在 5 分钟内未提取试运行结果,则会显示超时消息。

超时

建议:建议您验证 ADC 实例是否使用支持诊断的最新映像运行。此外,在资产选择表中,入职准备情况列显示为空白。

设备配置文件下拉列表中的红色轮廓

ADC 身份验证在试运行期间失败,设备配置文件下拉列表中出现红色轮廓。

配置文件错误

建议:再次重新输入 ADC 用户管理员凭据,创建设备配置文件,然后单击“测试”再次运行试运行。

使用诊断工具或 ADM GUI 对问题进行故障排除