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 工具转换策略表达式

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 设备

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