使用作业升级 NetScaler® 实例

您可以使用 NetScaler Console 升级一个或多个 NetScaler 实例。在升级实例之前,您必须了解许可框架和许可证类型。

注意: 如果您要升级具有经典策略的实例,我们建议您在使用 NSPEPI 工具升级实例之前,将经典策略转换为高级策略。这适用于 NSPEPI 工具支持的功能。有关详细信息,请参阅使用经典策略进行配置的升级注意事项

通过创建维护作业升级 NetScaler 实例时,请对要升级的实例执行预验证检查。

预验证检查

  1. 检查自定义项 - 备份您的自定义项并将其从实例中删除。实例升级后,您可以重新应用已备份的自定义项。

  2. 检查磁盘使用情况 - 如果 /var 文件夹的空间小于 6 GB,且 /flash 文件夹的空间小于 200 MB,请清理磁盘空间。检查以下文件夹路径以清理磁盘空间:

    • /var/nstrace
    • /var/log
    • /var/nslog
    • /var/tmp/support
    • /var/core
    • /var/crash
    • /var/nsinstall
    • /var/netscaler/nsbackup
  3. 检查磁盘硬件问题 - 如果存在任何硬件问题,请解决它们。

  4. 检查 STAYPRIMARY 和 STAYSECONDARY 节点 - 对于 NetScaler HA,处于 STAYPRIMARY 和 STAYSECONDARY 状态的节点将阻止升级。这些节点在预验证检查中被识别,并列在阻止升级的实例下。

预升级验证报告

NetScaler 高可用性对

升级 NetScaler HA 对时,请注意以下事项:

  • 辅助节点首先升级。

  • 节点同步和传播在两个节点成功升级之前处于禁用状态。

  • HA 对成功升级后,执行历史记录中会出现一条错误消息。如果 HA 对中的节点位于不同的内部版本或版本上,则会出现此消息。此消息表示主节点和辅助节点之间的同步已禁用。

您可以分两个阶段升级 NetScaler HA 对:

  1. 创建升级作业并立即在一个节点上运行,或稍后安排运行。

  2. 安排升级作业稍后在剩余节点上运行。确保在初始节点升级后安排此作业。

NetScaler 群集

升级 NetScaler 群集时,NetScaler Console 仅对指定实例执行预升级验证。在升级之前,请检查并解决群集节点上的自定义项、磁盘使用情况和硬件问题。

创建升级维护作业以升级 NetScaler 实例

注意

不支持从较高版本升级到较低版本的 NetScaler。例如,如果您的 NetScaler 实例是 13.0 82.x,则无法将 NetScaler 实例降级到 13.0 79.x 或任何其他早期版本。

  1. 在 NetScaler Console 中,导航到基础结构 > 升级作业。单击创建作业按钮。

  2. 创建维护作业中,选择升级 NetScaler(独立/高可用性/群集),然后单击继续

    选择升级维护作业

  3. 选择实例中,为作业名称键入您选择的名称。

  4. 单击添加实例以添加要升级的 NetScaler 实例。

    • 要升级 NetScaler 高可用性对,请选择高可用性对的 IP 地址(由“S”和“P”上标表示)。

    • 要升级群集,请选择群集 IP 地址(由“C”上标表示)。

    添加实例以升级维护作业

  5. 选择映像选项卡中,从本地驱动器或内部版本映像中选择 NetScaler 映像。

    • 本地 - 从本地计算机中选择实例升级文件。

    • 设备 - 从 NetScaler Console 文件浏览器中选择实例升级文件。NetScaler Console GUI 显示 /var/mps/ns_images 中存在的实例文件。

    选择映像以升级维护作业

    选择映像以升级维护作业

    • 如果选定的映像已可用,则跳过将映像上传到 NetScaler - 此选项检查选定的映像是否在 NetScaler 中可用。升级作业将跳过上传新映像,并使用 NetScaler 中可用的映像。

    • 成功升级后从 NetScaler 清理软件映像 - 此选项在实例升级后清除 NetScaler 实例中已上传的映像。

    单击下一步以开始对选定实例进行预升级验证。

    注意:

    • 下载的 NetScaler 映像存储在 NetScaler Console 代理中,并位于 /var/mps/adcimages 中。这些缓存的映像可用于多次 NetScaler 升级,从而无需每次升级都下载映像。
    • NetScaler Console 根据映像的上次修改时间每三天清除一次缓存的 NetScaler 映像。NetScaler Console 代理中一次仅缓存最新的两个映像文件。
  6. 预升级验证选项卡显示以下部分:
    • 准备升级的实例。您可以继续升级这些实例。

    • 阻止升级的实例。由于预升级验证错误,这些 NetScaler 实例被阻止升级。

      您可以查看、纠正错误,然后单击移至准备升级以升级它们。如果实例上磁盘空间不足,您可以检查并清理磁盘空间。请参阅清理 NetScaler 磁盘空间

    • 策略检查:如果 NetScaler Console 发现不受支持的经典策略,您可以删除此类策略以创建升级作业。

    重要:

    如果指定群集 IP 地址,NetScaler Console 仅对指定实例执行预升级验证,而不对其他群集节点执行。

    要在升级期间查看主节点和辅助节点之间的差异,请选择高可用性节点,然后单击详细信息

    预升级验证报告

    预升级验证报告

    • 在 HA 主节点中发现的配置差异 - 显示在 NetScaler 高可用性对的辅助节点中找到但主节点中缺少的全部配置。

    • 在 HA 辅助节点中发现的配置差异 - 显示在 NetScaler 高可用性对的主节点中找到但辅助节点中缺少的全部配置。

    注意:

    您可以忽略配置差异部分中可能出现的以下差异:

    • 设备特定配置,例如 IP 地址。

    • 加密密码或证书,即使密码相同,它们在节点之间也可能不同。

    您可以查看差异并选择忽略它们(如果它们不相关)。

  7. 验证脚本中,指定在实例升级之前和之后运行的脚本。您可以执行以下任一操作:

    • 默认验证脚本 - 选择此选项以运行预定义的验证脚本。这些脚本在升级作业之前和之后运行,为验证脚本生成差异报告。

      注意:

      您无法更改或编辑此预定义命令集。

    • 自定义验证脚本 - 选择此选项以运行您的验证脚本。您可以指定是希望脚本在升级之前还是之后运行。仅当在升级之前和之后选择了相同的脚本时,才会生成差异报告。

    要了解每个配置中的命令集,请单击查看详细信息

    验证脚本

    自定义验证脚本中,指定在实例升级之前和之后运行的脚本。使用以下方法之一运行 NetScaler CLI 命令:

    自定义脚本用于检查 NetScaler 实例升级前后的更改。例如:

    • 升级前后的实例版本。
    • 升级前后接口、高可用性节点、虚拟服务器和服务的状态。
    • 虚拟服务器和服务的统计信息。
    • 动态路由。

    实例升级有多个阶段。您现在可以指定这些脚本在以下阶段运行:

    • 预升级:指定脚本在升级实例之前运行。

    • 升级后故障转移前(适用于 HA):此阶段仅适用于高可用性部署。指定脚本在升级节点之后、但在其故障转移之前运行。

    • 升级后(适用于独立)/升级后故障转移后(适用于 HA):指定脚本在独立部署中升级实例之后运行。在高可用性部署中,脚本在升级节点及其故障转移之后运行。

    注意:

    确保在所需阶段启用脚本执行。否则,指定的脚本将不会运行。

    您可以导入脚本文件或直接在 NetScaler Console GUI 中键入 NetScaler CLI 命令。

    • 使用与预升级相同的脚本:对预升级、故障转移前和升级后使用相同的自定义脚本。
    • 从文件导入命令:从本地计算机中选择 NetScaler CLI 命令输入文件。
    • 键入命令:直接在 GUI 上输入 NetScaler CLI 命令。
  8. 计划任务中,选择以下选项之一:

    • 立即升级 - 升级作业立即运行。

    • 稍后计划 - 选择此选项可稍后运行此升级作业。指定要升级实例的执行日期开始时间

      如果要分两个阶段升级 NetScaler HA 对,请选择对 HA 中的节点执行两阶段升级

      指定要升级 HA 对中另一个实例的执行日期开始时间

      计划任务

  9. 创建作业中,指定以下详细信息:

    1. 软件映像列表中选择以下选项之一:

      • 本地 - 从本地计算机中选择实例升级文件。

      • 设备 - 从文件浏览器中选择实例升级文件。NetScaler Console GUI 显示 /var/mps/mps_images 中存在的实例文件。

    2. 指定何时将映像上传到实例:

      • 立即上传 - 选择此选项可立即上传映像。但是,升级作业将在计划时间运行。

      • 在执行时上传 - 选择此选项可在升级作业执行时上传映像。

      对于高可用性对,您可以指定要将映像上传到的节点:

      • 上传到主节点和辅助节点:将内部版本映像文件上传到主节点和辅助节点。

      • 仅上传到辅助节点:仅将内部版本映像文件上传到辅助节点。辅助节点升级后,将发生故障转移,内部版本映像文件将上传到新的辅助节点(以前是主节点)。

    NetScaler 高可用性升级到节点

    有关高可用性对的可用计划方案的详细信息,请参阅为 NetScaler 高可用性对计划升级作业

    • 成功升级后从 NetScaler 清理软件映像 - 选择此选项可在实例升级后清除 NetScaler 实例中已上传的映像。

    • 在开始升级之前备份 NetScaler 实例。 - 创建所选 NetScaler 实例的备份。

    • 升级后维护 HA 节点的主状态和辅助状态:如果要让升级作业在每个节点升级后启动故障转移,请选择此选项。通过这种方式,升级作业可以维护节点的主状态和辅助状态。

    • 在开始升级之前保存 NetScaler 配置 - 在升级 NetScaler 实例之前保存正在运行的 NetScaler 配置。

    • 启用 ISSU 以避免 NetScaler HA 对上的网络中断 - ISSU 确保 NetScaler 高可用性对上的零停机升级。此选项提供了一种迁移功能,可在升级期间保留现有连接。因此,您可以无停机地升级 NetScaler HA 对。以分钟为单位指定 ISSU 迁移超时。

    • 通过电子邮件接收执行报告 - 通过电子邮件发送执行报告。要添加电子邮件通讯组列表,请参阅创建电子邮件通讯组列表

    • 通过 Slack 接收执行报告 - 通过 Slack 发送执行报告。要添加 Slack 配置文件,请参阅创建 Slack 配置文件

    单击创建作业

升级作业显示在基础结构 > 升级作业中。编辑现有作业时,如果所需字段已填写,则可以切换到任何选项卡。例如,如果您在选择配置选项卡中,则可以切换到作业预览选项卡。

暂停或恢复计划的升级作业

您还可以暂停计划的升级作业。

要使用此功能,请导航到基础结构 > 升级作业,选择一个现有计划的升级作业,然后单击停止以暂停作业。要恢复计划的升级作业,请单击恢复

停止或恢复计划的作业

注意:

如果在您决定恢复升级作业后,计划的升级作业时间已过,则需要重新创建升级作业。

重试失败的升级作业

  1. 基础结构 > 升级作业中,选择失败的升级作业,然后单击重试。或者,您也可以转到选择操作 > 重试升级作业以重试失败的作业。

    重试失败的作业

  2. 选择实例中,指定以下详细信息:

    • 作业名称 - 输入升级的名称。

    • 从列表中选择要升级的 NetScaler 实例。要删除任何实例,请单击删除

    单击下一步以开始验证过程。

    重试失败的作业

  3. 预升级验证选项卡显示以下部分:
    • 准备升级的实例。您可以继续升级这些实例。

    • 阻止升级的实例。由于预升级验证错误,这些 NetScaler 实例被阻止升级。

      您可以查看、纠正错误,然后单击移至准备升级以升级它们。如果实例上磁盘空间不足,您可以检查并清理磁盘空间。请参阅清理 NetScaler 磁盘空间

    • 策略检查:如果 NetScaler Console 发现不受支持的经典策略,您可以删除此类策略以创建升级作业。

    重试失败的作业

    单击下一步

  4. 计划任务中,选择以下选项之一:

    • 立即升级:升级作业立即运行。

    • 稍后计划:选择此选项可稍后运行此升级作业。指定要升级实例的执行日期开始时间

    重试失败的作业

    单击重试

清理 NetScaler 磁盘空间

如果在升级 NetScaler 实例时遇到磁盘空间不足问题,请直接从 NetScaler Console GUI 清理磁盘空间。

  1. 预升级验证选项卡中,阻止升级的实例部分显示因磁盘空间不足而升级失败的实例。选择存在磁盘空间问题的实例。

  2. 单击检查磁盘空间

    将显示磁盘空间详细信息页面。此页面显示实例、已用内存和可用内存。

    磁盘空间详细信息

  3. 磁盘空间详细信息窗格中,选择需要清理的实例,然后执行以下操作之一:

    1. 磁盘清理 - 导航到所需的文件夹或目录并将其删除以释放磁盘空间。

    2. 快速清理 - 通过删除多个文件夹快速清理磁盘空间。在出现的确认窗格中,选择要删除的文件夹,然后单击

      快速清理

    3. 清理磁盘空间后,您可以检查现在是否有足够的磁盘空间来升级实例。在阻止升级的实例部分中,单击重新验证

      在以下示例中,磁盘空间可用。您现在可以单击移至准备升级以升级实例,或单击下一步以继续下一步。

      验证清理

计划 NetScaler 高可用性对的升级作业

下表列出了计划任务页面中的不同计划方案以及创建作业页面中相应的升级选项:

您希望何时执行升级作业? 您希望何时将软件映像上传到 NetScaler? 您希望如何将内部版本映像上传到 HA 节点?
立即升级 不适用 上传到主节点和辅助节点(默认选项)
稍后计划 在执行时上传(默认选项) 上传到主节点和辅助节点(默认选项)
立即上传
稍后计划(当选择对 HA 中的节点执行两阶段升级时) 在执行时上传(默认选项) 仅上传到辅助节点(默认且唯一选项)
立即上传

下载 NetScaler 升级作业的合并差异报告

如果指定了自定义脚本,您可以下载 NetScaler 升级作业的差异报告。差异报告包含预升级脚本和升级后脚本输出之间的差异。通过此报告,您可以确定 NetScaler 实例升级后发生了哪些更改。

注意

仅当您在预升级和升级后阶段指定相同的脚本时,才会生成差异报告。

要下载升级作业的差异报告,请执行以下操作:

  1. 导航到基础结构 > 升级作业

  2. 选择要下载差异报告的升级作业。

  3. 单击差异报告

  4. 差异报告中,下载所选升级作业的合并差异报告。

    在此页面中,您可以下载以下任何差异报告:

    • 预升级与升级后故障转移前差异报告
    • 预升级与升级后差异报告

    下载 NetScaler 升级作业的差异报告