使用作业升级 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 高可用性对

• 首先升级辅助节点。
• 在两个节点都成功升级之前，节点同步和传播将处于禁用状态。
• HA 对成功升级后，执行历史记录中会出现一条错误消息。如果 HA 对中的节点处于不同的内部版本或版本，则会出现此消息。此消息表示主节点和辅助节点之间的同步已禁用。

1. 创建升级作业并立即在一个节点上运行，或稍后安排运行。
2. 稍后安排升级作业在剩余节点上运行。请务必在初始节点升级后安排此作业。

NetScaler 群集

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

1. 在 NetScaler Console 中，导航到 Infrastructure > Upgrade Jobs。单击 Create Job 按钮。
2. 在 创建维护作业 中，选择 升级 NetScaler（独立/高可用性/集群），然后单击 继续。
   
3. 在 Select Instance 中，为 Job Name 键入您选择的名称。
4. 单击 Add Instances 以添加要升级的 NetScaler 实例。
   • 要升级 NetScaler 高可用性对，请选择高可用性对的 IP 地址（由“S”和“P”的上标表示）。
   • 要升级群集，请选择群集 IP 地址（由“C”的上标表示）。
   
5. 在 Select Image 选项卡中，从本地驱动器或构建映像中选择 NetScaler 映像。
   • Local - 从本地计算机中选择实例升级文件。
   • Appliance - 从 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 高可用性节点升级(/en-us/netscaler-application-delivery-management-software/media/upgrade-create-job-ns.png)
   有关高可用性对的可用调度方案的更多信息，请参阅为高可用性对调度升级作业。
   • 成功升级后从 NetScaler 清理软件镜像 - 选择此选项可在实例升级后清除 NetScaler 实例中上传的镜像。
   • 在开始升级之前备份 NetScaler 实例。 - 创建所选 NetScaler 实例的备份。
   • 升级后保持 HA 节点的主备状态：如果您希望升级作业在每个节点升级后启动故障转移，请选择此选项。这样，升级作业将保持节点的主备状态。
   • 在开始升级之前保存 NetScaler 配置 - 在升级 NetScaler 实例之前保存正在运行的 NetScaler 配置。
   • 启用 ISSU 以避免 NetScaler HA 对的网络中断 - ISSU 确保 NetScaler 高可用性对的零停机升级。此选项提供迁移功能，可在升级期间保留现有连接。因此，您可以零停机升级 NetScaler HA 对。以分钟为单位指定 ISSU 迁移超时。
   • 通过电子邮件接收执行报告 - 通过电子邮件发送执行报告。要添加电子邮件分发列表，请参阅创建电子邮件分发列表。
   • 通过 Slack 接收执行报告 - 通过 Slack 发送执行报告。要添加 Slack 配置文件，请参阅创建 Slack 配置文件。
   单击创建作业。

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

重试失败的升级作业

1. 在 Infrastructure > Upgrade Jobs 中，选择失败的升级作业，然后单击 Retry。或者，您也可以转到 Select Action > Retry Upgrade Job 以重试失败的作业。
   
2. 在 Select Instance 中，指定以下详细信息：
   • 作业名称 - 输入升级的名称。
   • 从列表中选择要升级的 NetScaler 实例。要删除任何实例，请单击 Remove。
   单击 Next 开始验证过程。
   
3. 升级前验证选项卡显示以下部分：
   • 准备升级的实例。您可以继续升级这些实例。
   • 被阻止升级的实例。这些 NetScaler 实例因升级前验证错误而被阻止升级。
     您可以查看、纠正错误，然后点击 Move to ready for upgrade 来升级它们。如果实例上磁盘空间不足，您可以检查并清理磁盘空间。请参阅，清理 NetScaler 磁盘空间。
   • 策略检查：如果 NetScaler Console 发现不支持的经典策略，您可以删除此类策略以创建升级作业。
   
   点击 Next。
4. 在 Schedule Task 中，选择以下选项之一：
   • 立即升级：升级作业会立即运行。
   • 稍后计划：选择此选项可稍后运行此升级作业。指定您要升级实例的执行日期和开始时间。
   
   点击 Retry。

清理 NetScaler 磁盘空间

1. 在升级前验证选项卡中，阻止升级的实例部分显示因磁盘空间不足而升级失败的实例。选择存在磁盘空间问题的实例。
2. 点击 检查磁盘空间。
   将显示磁盘空间详细信息页面。此页面显示实例、已用内存和可用内存。
   
3. 在“磁盘空间详细信息”窗格中，选择需要清理的实例，然后执行以下操作之一：
   1. 磁盘清理 - 导航到所需的文件夹或目录并将其删除以释放磁盘空间。
   2. 快速清理 - 通过删除多个文件夹快速清理磁盘空间。在出现的“确认”窗格中，选择要删除的文件夹，然后单击“是”。
      
   3. 清理磁盘空间后，您可以检查是否有足够的磁盘空间来升级实例。在“阻止升级的实例”部分中，单击“重新验证”。
      在以下示例中，磁盘空间可用。您现在可以单击“移至准备升级”以升级实例，或单击“下一步”以继续执行下一步。
      

为 NetScaler 高可用性对安排升级作业

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

1. 导航到 基础设施 > 升级作业。
2. 选择要下载差异报告的升级作业。
3. 单击 Diff Reports。
4. 在 Diff Reports 中，下载所选升级作业的合并差异报告。
   在此页面中，您可以下载以下任何差异报告：
   • 升级前与升级后故障转移前差异报告
   • 升级前与升级后差异报告