ADC

使用经典策略的配置的升级注意事项

NetScaler 版本 12.0 内部版本 56.20 已弃用经典策略。从版本 13.1 开始,经典策略支持已从某些功能中删除。要了解 13.1 版不支持的功能或命令的完整列表,请参阅 NetScaler Classic 策略特性和功能状态变更通知 中的 表 2

作为升级到 13.1 版或更高版本的必备条件,我们建议您将经典策略转换为 NSPEPI 工具支持的功能的高级策略。要了解 NSPEPI 工具支持的功能,请参阅 nspepi 转换工具处理的命令或功能。如果您在升级之前没有转换为高级策略,则由于配置无效,升级将失败。

重要:

在升级到 13.1 或更高版本之前,我们建议您运行预配置检查工具。此工具可确保您的配置不包含与已弃用或已删除功能相关的命令。如果有任何与已弃用或已删除的功能相关的命令,则该工具会引发错误,并且配置可能会丢失。我们建议您从公开的 GitHub 链接下载最新版本的预配置检查工具 - https://github.com/citrix/ADC-scripts/tree/master/nspepi

有关更多信息,请参阅 升级前的预配置检查工具

如果在预配置检查中出现任何错误,我们建议您使用 nspepi 工具将无效配置转换为有效配置。从公开的 GitHub 链接下载 nspepi 工具的最新版本- https://github.com/citrix/ADC-scripts/tree/master/nspepi。有关使用 nspepi 工具转换策略表达式的更多信息,请参阅使用 NSPEPI 工具转换策略表达式

如果您在升级之前错过了经典策略的转换,则可以选择在升级期间转换为高级策略。作为升级的一部分,您可以在运行 ./installns 命令时选择下表中描述的选项之一。

选项 说明
别无选择 如果在预配置检查中出现任何错误,安装将停止。必须将经典策略转换为高级策略才能继续升级过程。
-M NSPEPI 工具作为安装的一部分运行,可将经典策略转换为高级策略。
-Y 不建议使用此选项。在此选项中,会跳过预配置检查,因此任何有效的配置都可能丢失。

要在升级期间将经典策略转换为高级策略,请选择 -M 选项。-M 选项触发 NSPEPI 工具并使用修改后的配置更新现有 ns.conf 文件。旧配置现存于 /nsconfig/ns.conf_old,以供将来参考。

./installns -M`
<!--NeedCopy-->

如果您在高级策略转换过程中发现任何错误,请联系 NetScaler 支持人员。

nspepi 工具不处理一些命令或功能的转换。有关完整列表,请参阅 nspepi 转换工具未处理的命令或功能

注意:

如果您有经典策略并希望在升级期间将其转换为高级策略,则可以使用常规升级程序(HA、群集或独立设置),但要在 installns 命令中使用“-M”选项。

如果要在升级之前转换配置,请对每种配置执行以下步骤:

  1. 在 Citrix ADC 版本 12.1 或 13.0 上运行 nspepi 工具来转换 ns.conf 文件。NSPEPI 工具生成两个带有前缀 new_warn_ 的文件。带有 new_ 前缀的文件包含转换后的配置,带有 warn_ 前缀的文件包含警告和错误。
  2. 检查带有 warn_ 前缀的文件并修复错误(如果有)。
  3. 测试转换后的配置。使用以下选项之一应用转换后的配置:
    1. 运行该 clear config -f basic 命令,然后通过运行该 source /nsconfig/new_ns.conf 命令获取转换后的配置。
    2. 手动删除经典命令(通过解除绑定和删除策略),然后通过运行该 source /nsconfig/new_ns.conf 命令获取转换后的配置。

      注意:

      对于未使用 clear config -f basic命令清除的配置,您可能会看到“资源已存在”错误。您可以忽略这些错误。

  4. 保存配置。

成功将无效配置转换为有效配置后,请验证是否还有其他必备条件,然后继续升级。有关更多信息,请参阅升级和降级 NetScaler 设备

使用经典策略的配置的升级注意事项

在本文中