对与安装、升级和降级过程相关的问题进行故障排除

2021年8月24日

贡献者:

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

故障排除的资源

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

来自设备的配置文件。如果是高可用性对，则为两台设备中的配置文件。
设备中的以下文件：
- 相关newnslog文件。
- ns.log文件。
- 消息文件。
网络拓扑图。

问题和解决方案

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

问题
由于硬件和软件不兼容,升级Citrix ADC MPX设备失败。
解决方案
请参阅Citrix ADC MPX硬件——软件兼容性表,并检查Citrix ADC MPX硬件是否支持该软件版本。
问题
由于Citrix ADC VPX设备和虚拟机管理程序不兼容,升级Citrix ADC VPX设备失败。
解决方案
请参阅Citrix ADC VPX设备和虚拟机管理程序兼容性列表,并检查虚拟机管理程序是否支持Citrix ADC VPX设备型号。
问题
由于硬件错误,升级Citrix ADC设备失败。
解决方案
验证Citrix ADC设备的完整性。如果您有Citrix ADC硬件设备,Citrix建议运行fsck以运行磁盘检查和验证Citrix ADC硬盘的完整性。
有关更多信息,请参阅如何验证Citrix ADC设备的文件系统完整性。
问题
使用GUI摊位升级Citrix ADC设备。
解决方案
刷新浏览器以检查升级是否正在进行。
问题
由于/ var目录中的空间不足,升级Citrix ADC设备失败
解决方案
释放/ var目录上的空间。有关更多信息，请参阅如何在/ var目录上释放空间。
问题
软件降级后无法访问Citrix ADC
原因
在软件降级过程中,如果现有发行版和内部版本的配置文件与早期发行版和内部版本的配置文件不匹配,设备将无法加载配置,并且将为设备分配默认IP地址。
解决方案
- 验证是否可以从控制台访问设备。
- 验证设备上的NSIP地址和路由。
  - 如果IP地址已更改为默认的192.168.100.1 IP地址,请根据需要更改IP地址。
  - 验证设备是否可访问。
问题
升级期间，如果我运行同步命令，则会显示以下消息：
命令在辅助节点上运行失败，但在主节点上成功运行。
解决方案
在进行高可用性(HA)同步时,请勿运行任何依赖命令(设置/设置/ bind / unbind)。
问题
在升级过程中，运行强制故障转移命令时，流量不会通过新主节点传输。
解决方案
- 检查网络拓扑和交换机配置是否存在问题。
- 运行设置L2param -garpreply启用命令以启用GARP答复。
- 如果尚未使用,请尝试使用虚拟MAC。
- 运行sendarp——主节点上的命令。
问题
升级或降级Citrix ADC设备后,通过SSH连接到设备失败。
解决方案
在Citrix ADC设备中执行以下操作:
- 删除旧的或不安全的主机密钥，位置为/ nsconfig / ssh / ssh_host_ *。
- 查看自定义SSHD配置(位置为/ nsconfig /中），然后检查其是否仍然相关且兼容。相应地重命名或删除自定义SSHD配置。
- 冷重启Citrix ADC设备
问题
在高可用性对中，运行高可用性强制故障转移命令后，设备将继续重新启动。升级后辅助设备无法启动。
解决方案
检查/ var目录是否已满载。如果是，请删除旧安装文件。运行df - h命令以显示可用的磁盘空间。
问题
升级高可用性对后,其中一个节点被列为状态未知。
解决方案
- 检查两个节点是否正在运行同一版本。如果内部版本不同,且高可用性节点版本不匹配,则在运行显示ha节点命令时,某些字段将显示为未知。
- 检查辅助设备是否可访问。
问题
升级Citrix ADC后,界面显示大多数负载平衡虚拟服务器和服务都处于关闭状态。
解决方案
验证辅助设备上的剪断地址是否处于激活状态。此外,请键入显示服务命令以查看服务是否正在运行。
问题
执行升级后，辅助设备上的所有虚拟服务器都处于关闭状态。
解决方案
通过运行以下命令启用高可用性状态和高可用性同步：
- 设置节点hastate为enable
- 设置节点hasync enable
不建议禁用高可用性。
问题
执行降级后,Citrix ADC无法正常启动。
解决方案
检查是否安装了正确的许可证。
问题
在高可用性对中，某些功能在执行升级后不会同步。
解决方案
运行同步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  
```
注意:模式集仅在9.3版或更高版本中受支持。
问题
升级Citrix ADC VPX设备时,我被告知要释放/ var中的空间。我该删除哪些文件？
解决方案
请从/var/tmp/目录中删除旧安装文件。还可以从/ flash中删除不需要的文件。
问题
在辅助设备上运行高可用性强制故障转移命令时,未与图形用户界面(GUI)建立连接。
解决方案
请使用命令行界面登录辅助设备,然后通过运行设置ns ip < ip > GUI启用命令来启用对GUI的访问。
问题
执行升级后,当我单击GUI上必须加载java小程序的任何链接(升级向导或许可证向导)时,将显示以下错误消息:GUI版本与内核版本不匹配。请关闭此实例，清除java插件缓存并重新打开(GUI版本与内核版本不匹配。请关闭此实例,清除java插件缓存并重新打开)。
解决方案
- 使用GUI登录Citrix ADC。
- 导航到“Citrix ADC网关”(Citrix ADC网关)>“全局设置”(全局设置)。
- 单击“设置”(设置)下的“更改全局设置”(更改全局设置)。
- 在详细信息窗格的“客户体验”(客户端体验)下,从UI主题列表中选择“默认”(默认)。
- 单击OK(确定)。
问题
如果由于任何原因升级Citrix ADC设备失败,如何使用备份的文件还原设备?
解决方案
如果升级不成功,请使用备份的文件将设备还原到Citrix ADC设备的早期版本。有关更多信息,请参阅备份和还原Citrix ADC设备。
有关备份和还原Citrix ADC群集设置的详细信息,请参阅集群设置的备份和还原。
问题
如果Citrix ADC设备升级失败后许可证丢失,如何解决该问题吗?
解决方案
如果缺少任何许可证或者您想重新分配许可证，请参阅以下主题许可概述。

注意

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

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

本内容的正式版本为英文版。部分Citrix文档内容采用了机器翻译,仅供您参考。Citrix 无法控制机器翻译的内容，这些内容可能包含错误、不准确或不合适的语言。对于从英文原文翻译成任何其他语言的内容的准确性、可靠性、适用性或正确性，或者您的 Citrix 产品或服务沿用了任何机器翻译的内容，我们均不作任何明示或暗示的保证，并且适用的最终用户许可协议或服务条款或者与 Citrix 签订的任何其他协议（产品或服务与已进行机器翻译的任何文档保持一致）下的任何保证均不适用。对于因使用机器翻译的内容而引起的任何损害或问题，Citrix 不承担任何责任。

对与安装、升级和降级过程相关的问题进行故障排除

2021年8月24日

贡献者:

2021年8月24日

贡献者:

对与安装、升级和降级过程相关的问题进行故障排除

故障排除的资源

问题和解决方案

本文中包含的内容