Citrix ADC

故障排除

如果设备在完成安装、升级或降级过程后无法按预期工作,首先要执行的操作是检查问题的最常见原因。

用于故障排除的资源

为获得最佳效果,请使用以下资源解决与 Citrix ADC 的安装、升级或降级相关的问题:

  • 设备中的配置文件。在高可用性对的情况下,两个设备的配置文件。
  • 来自设备的以下文件:
    • 相关的 newnslog 文件。
    • ns.log 文件。
    • 消息文件。
  • 网络拓扑逻辑示意图。

故障排除与安装、升级和降级过程有关的问题

以下是最常见的安装、升级和降级问题以及解决这些问题的提示:

  • 问题

    软件降级后无法访问 Citrix ADC

    原因

    在软件降级过程中,如果现有版本和版本的配置文件与早期版本和版本的配置文件不匹配,则设备无法加载配置,并且将默认 IP 地址分配给设备。

    分辨率

    • 验证是否可以从控制台访问设备。
    • 验证设备上的 NSIP 地址和路由。
      • 如果 IP 地址已更改为默认的 192.168.100.1 IP 地址,请根据需要更改 IP 地址。
      • 验证设备是否可访问。
  • 问题

    在升级过程中,如果我运行同步命令,则会显示以下消息:

    命令在辅助节点上失败,但在主节点上成功。

    分辨率

    高可用性 (HA) 同步正在进行时,不要运行任何依赖命令(设置/取消设置/绑定/取消绑定)。

  • 问题

    在升级过程中,当您运行强制故障转移命令时,流量不会通过新的主节点。

    分辨率

    • 检查网络拓扑和交换机配置的问题。
    • 运行集合 L2param-完全启用命令以启用 GARP 回复。
    • 如果尚未使用,请尝试使用虚拟 MAC。
    • 运行 sendarp-来自主节点的命令。
  • 问题

    在 HA 对中,运行强制 HA 故障转移命令后,设备会继续重新启动。升级后,辅助设备不会出现。

    分辨率

    检查 /var 目录是否已满。如果是这样,请删除旧的安装文件。运行 df —h 命令以显示可用磁盘空间。

  • 问题

    升级 HA 对后,其中一个节点被列为状态未知。

    分辨率

    • 检查两个节点是否运行相同的构建。如果版本不相同且 HA 节点的版本不匹配,则运行 show ha 节点命令时,某些字段将显示为“未知”。
    • 检查辅助设备是否可以访问。
  • 问题

    升级 Citrix ADC 后,接口会显示大多数负载平衡虚拟服务器和服务均为“关闭”。

    分辨率

    验证 SNIP 地址在辅助设备上处于活动状态。此外,键入 show service 命令以查看服务是否正在运行。

  • 问题

    执行升级后,辅助设备上的所有虚拟服务器都会关闭。

    分辨率

    通过运行以下命令启用 HA 状态和 HA 同步:

    • 设置节点启用
    • 设置节点 Hasync 启用

    不建议禁用 HA。

  • 问题

    执行降级后,Citrix ADC 无法正常启动。

    分辨率

    检查是否已安装正确的许可证。

  • 问题

    在 HA 对中,某些功能在执行升级后不会同步。

    分辨率

    运行同步 ha 文件 misc 命令,将配置文件从主节点同步到辅助节点。

  • 问题

    在重新启动过程中,将显示以下错误消息:

    ns.conf 中的一个或多个命令失败,我应该怎么做?

    分辨率

    确保 ns.conf 文件中没有任何命令超过 255 字节限制。在创建超过 255 字节限制的策略时间过长的命令中,您可以使用模式集缩短策略。

    示例:

     add cs policy p11 -rule 'HTTP.REQ.URL.ENDSWITH_ANY("ctx_file_extensions")'
     Done
    

    ctx_file_extensions 是一个默认的修补集,它涵盖了大量扩展。除了默认模式集之外,您还可以创建用户定义的模式集。通过运行以下命令添加补丁集:

     add patset <name>
    

    注意:仅在版本 9.3 或更高版本中支持修补集。

  • 问题

    升级 Citrix ADC VPX 设备时, 我被告知释放空间/var. 我可以删除哪些文件?

    分辨率

    从 /var/tmp/ 目录中删除旧的安装文件。还删除不需要的文件从/flash。

  • 问题

    在辅助设备上运行强制 HA 故障转移命令时,没有连接到图形用户界面 (GUI)。

    分辨率

    使用命令行界面登录辅助设备,并通过运行启用了设置 ns ip <IP>-gui 的命令来启用对 GUI 的访问。

  • 问题

    执行升级后,当我单击必须加载 Java 小程序(升级向导或许可向导)GUI 上的任何链接时,会出现以下错误消息:GUI 版本与内核版本不匹配。请关闭此实例,清除 java 插件缓存并重新打开

    分辨率

    • 使用 GUI 登录到 Citrix ADC。
    • 导航至 Citrix ADC 网关 > 全局设置。
    • 单击设置下的更改全局设置。
    • 在详细信息窗格的客户端体验下,从 UI 主题列表中选择默认值。
    • 单击确定。
  • 问题

    如果由于任何原因升级 Citrix ADC 设备失败,如何使用备份文件还原设备?

    分辨率

    如果升级失败,请使用备份文件将设备还原到以前版本的 Citrix ADC 设备。有关详细信息,请参阅备份和还原 Citrix ADC 设备

    有关 Citrix ADC 群集设置的备份和还原的详细信息,请参阅集群设置的备份和还原

  • 问题

    如果 Citrix ADC 设备升级失败后遗失许可证,如何解决此问题?

    分辨率

    如果缺少任何许可证或者您想要重新分配许可证,请参阅以下主题许可概览

注意

这些故障排除步骤也适用于在多个版本中降级软件时配置丢失的问题。

有关任何其他问题,请参阅发行说明、知识中心文章和常见问题解答。

故障排除