Citrix ADC

处理安装、升级和降级过程相关问题

如果在完成安装、升级或降级过程后,设备没有按预期工作,首先要做的是检查导致问题的最常见原因。

故障排除资源

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

  • 来自设备的配置文件。对于高可用性对,来自两个设备的配置文件。
  • 设备中的以下文件:
    • 相关的新闻日志文件。
    • ns.log文件。
    • 消息文件。
  • 网络拓扑图。

问题和解决方案

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

  1. 问题

    升级Citrix ADC MPX设备失败,原因是硬件和软件不兼容。

    决议

    看到Citrix ADC MPX软硬件兼容性矩阵查看Citrix ADC MPX硬件是否支持该软件版本。

  2. 问题

    升级Citrix ADC VPX设备失败,原因是Citrix ADC VPX设备和管理程序不兼容。

    决议

    看到Citrix ADC VPX设备和hypervisor兼容性矩阵并检查该hypervisor上是否支持Citrix ADC VPX设备模型。

  3. 问题

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

    决议

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

    有关更多信息,请参见如何验证Citrix ADC设备的文件系统完整性

  4. 问题

    通过使用GUI档位升级Citrix ADC设备。

    决议

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

  5. 问题

    升级Citrix ADC设备失败,原因是/var目录空间不足

    决议

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

  6. 问题

    软件降级后,Citrix ADC不可访问

    导致

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

    决议

    • 验证可以从控制台访问设备。
    • 验证设备上的NSIP地址和路由。
      • 如果IP地址已修改为默认的192.168.100.1 IP地址,请根据实际情况进行修改。
      • 验证该设备是否可访问。
  7. 问题

    现象描述升级过程中,执行同步命令,界面显示如下:

    从节点命令执行失败,主节点命令执行成功。

    决议

    在HA同步过程中,不要执行任何依赖命令(set /unset /bind /unbind)。

  8. 问题

    在升级过程中,执行force failover命令时,流量不经过新主节点。

    决议

    • 检查网络拓扑和交换机配置是否有问题。
    • 执行set L2param -garpreply ENABLED命令开启GARP应答功能。
    • 如果还未使用,请尝试使用虚拟MAC。
    • 在主节点上执行sendarp -a命令。
  9. 问题

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

    决议

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

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

    HA pair执行force HA failover命令后,设备会不断重启。从端设备升级后无法启动。

    决议

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

  11. 问题

    升级HA pair后,有一个节点的状态显示为UNKNOWN。

    决议

    • 检查两个节点是否正在运行相同的构建。如果构建不一致,且HA节点版本不匹配,执行show HA node命令时,部分字段显示为UNKNOWN。
    • 检查辅助设备是否可达。
  12. 问题

    升级Citrix ADC后,界面显示大部分负载均衡虚拟服务器和服务都处于DOWN状态。

    决议

    在辅助设备上验证SNIP地址是活动的。此外,输入show service命令查看服务是否正在运行。

  13. 问题

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

    决议

    使用实例开启HA状态和HA同步。

    • 设置节点hastate为enable
    • 设置节点hasync enable

    不建议禁用HA功能。

  14. 问题

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

    决议

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

  15. 问题

    现象描述HA pair升级后,部分特性未同步。

    决议

    执行sync ha file misc命令,将配置文件从主节点同步到备节点。

  16. 问题

    在重新启动过程中,出现以下错误信息:

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

    决议

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

    例子:

    添加cs策略p11 -rule 'HTTP.REQ.URL.ENDSWITH_ANY("ctx_file_extensions")' Done 

    Ctx_file_extensions是一个默认的补丁集,它覆盖了大量的扩展。除了默认模式集,您还可以创建用户定义的模式集。以如下命令添加patset:

    添加patset  

    注意:Patsets仅在9.3或更高版本中支持。

  17. 问题

    当升级Citrix ADC VPX设备时,我被告知要释放/var中的空间。我要删除哪些文件?

    决议

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

  18. 问题

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

    决议

    使用命令行界面登录辅助设备,并运行set ns ip < ip > -gui enabled命令启用对GUI的访问。

  19. 问题

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

    决议

    • 该任务指导软件调测工程师通过GUI登录Citrix ADC。
    • 进入“Citrix ADC Gateway >全局设置”。
    • 单击“设置”下的“更改全局设置”。
    • 在详细信息窗格中,在客户端体验下,从UI主题列表中选择默认。
    • 单击OK。
  20. 问题

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

    决议

    如果升级不成功,则使用备份的文件将设备恢复到之前版本的Citrix ADC设备。有关更多信息,请参见备份和恢复Citrix ADC设备

    有关备份和恢复Citrix ADC集群设置的详细信息,请参见集群设置的备份和恢复

  21. 问题

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

    决议

    如果有license丢失或需要重新分配,请参考以下主题许可的概述

请注意

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

有关其他问题,请参见发行说明、知识中心文章和faq。

处理安装、升级和降级过程相关问题