Citrix ADC

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

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

用于故障排除的资源

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

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

问题和解决方案

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

  1. 问题

    由于硬件和软件不兼容,升级 Citrix ADC MPX 设备失败。

    分辨率

    请参阅 Citrix ADC MPX 硬件-软件兼容性矩阵 并检查 Citrix ADC MPX 硬件是否支持软件版本。

  2. 问题

    由于 Citrix ADC VPX 设备和虚拟机管理程序不兼容,升级 Citrix ADC VPX 设备失败。

    分辨率

    请参阅 Citrix ADC VPX 设备和虚拟机管理程序兼容性矩阵 并检查虚拟机管理程序是否支持 Citrix ADC VPX 设备型号。

  3. 问题

    由于硬件错误,升级 Citrix ADC 设备失败。

    分辨率

    验证 Citrix ADC 设备的完整性。如果您有 Citrix ADC 硬件设备,Citrix 建议运 fsck 行以运行磁盘检查和验证 Citrix ADC 硬盘的完整性。

    有关详细信息,请参阅如何验证 Citrix ADC 设备的文件系统完整性

  4. 问题

    使用 GUI 停顿升级 Citrix ADC 设备。

    分辨率

    刷新浏览器以检查升级是否正在进行。

  5. 问题

    由于 /var 目录中的空间不足,升级 Citrix ADC 设备失败

    分辨率

    释放 /var 目录上的空间。有关详细信息,请 参阅 如何在 /var 目录上释放空间

  6. 问题

    软件降级后无法访问 Citrix ADC

    原因

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

    分辨率

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

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

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

    分辨率

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

  8. 问题

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

    分辨率

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

    升级或降级 Citrix ADC 设备后,通过 SSH 连接到设备失败。

    分辨率

    在 Citrix ADC 设备中执行以下操作:

    • 在上删除旧或不安全的主机密钥 /nsconfig/ssh/ssh_host_*
    • 查看上的自定义 SSHD 配置, /nsconfig/sshd_config 然后检查它是否仍然相关和兼容。相应地重命名或删除自定义 SSHD 配置。
    • 冷重启 Citrix ADC 设备
  10. 问题

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

    分辨率

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

  11. 问题

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

    分辨率

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

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

    分辨率

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

  13. 问题

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

    分辨率

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

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

    不建议禁用 HA。

  14. 问题

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

    分辨率

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

  15. 问题

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

    分辨率

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

  16. 问题

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

    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 或更高版本中支持修补集。

  17. 问题

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

    分辨率

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

  18. 问题

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

    分辨率

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

  19. 问题

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

    分辨率

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

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

    分辨率

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

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

  21. 问题

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

    分辨率

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

注意

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

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

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