Citrix ADC

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

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

故障排除参考资料

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

  • 来自设备的配置文件。对于高可用性对,来自两个设备的配置文件。
  • 设备中的以下文件:
    • 相关newnslog文件。
    • nslog文件。
    • 消息文件。
  • 网络拓扑图。

问题和解决办法

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

  1. 问题

    Citrix ADC MPX一体机由于软硬件不兼容导致升级失败。

    决议

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

  2. 问题

    现象描述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. 问题

    升级Citrix ADC设备时,/var目录空间不足导致升级失败

    决议

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

  6. 问题

    软件降级后,Citrix ADC无法访问

    导致

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

    决议

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

    在升级过程中,如果执行同步命令,系统显示如下信息:

    备节点命令失败,主节点命令成功。处理步骤

    决议

    在HA (High Availability)同步过程中,不能执行任何相关命令(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
    • 启用节点hasync

    不建议禁用HA功能。

  14. 问题

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

    决议

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

  15. 问题

    在HA pair中,升级后部分特性不同步。

    决议

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

  16. 问题

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

    nsconf中的一个或多个命令失败了,我该怎么办?

    决议

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

    例子:

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

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

    添加patset  

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

  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网关>全局设置”。
    • 单击“设置”下的“更改全局设置”。
    • 在详细信息窗格中,在Client Experience下,从UI主题列表中选择Default。
    • 单击OK。
  20. 问题

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

    决议

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

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

  21. 问题

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

    决议

    如果任何许可证丢失或您想重新分配许可证,请参考以下主题许可的概述

请注意

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

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

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