升级

每个 NetScaler ADM 版本都提供了新功能和更新功能，并增强了功能。 Citrix 建议您将 NetScaler ADM 升级到最新版本以利用新功能和错误修复。 每次发布公告附带的 发行说明 中都包含增强功能、已知问题和错误修复的完整列表。 在开始升级之前，了解许可框架和可使用的许可证类型也很重要。 有关 NetScaler ADM 许可信息，请参阅许可。

升级路径信息也可在 Citrix 升级指南中找到。

升级之前

从 NetScaler ADM 下载页面下载升级包，然后按照本文中的说明将您的系统升级到最新的 13.1 版本。 升级过程开始后，ADM 将重新启动，现有连接将终止，并在升级完成时重新连接。 现有配置将被保留，但 NetScaler ADM 在升级完成之前不会处理任何数据。

重要的

NetScaler ADM 版本和构建版本应为 等于或高于您的 NetScaler 版本和构建版本 。 例如，如果您已安装 NetScaler ADM 12.1 Build 50.39，请确保已安装 NetScaler 12.1 Build 50.28/50.31 或更早版本。

升级到 13.1 之前需要注意的事项：

升级到 13.1 xx.xx 及更高版本之前需要注意的重要事项

当您将 ADM 软件升级到版本 13.1 xx.xx 时，您的 ADM 数据库也会被迁移。 发生此数据迁移是因为 ADM 现在使用 PostgreSQL 版本 10.11。

笔记

不支持降级 ADM 软件。 不要尝试降级。

建议的预防措施：

将单个 NetScaler ADM 服务器升级到 13.1-12.x

  1. 使用管理员凭据登录 NetScaler ADM。

  2. 导航到 设置 > 管理。 在 系统维护下，单击 升级 NetScaler ADM。

    升级 NetScaler ADM

  3. 在 升级 NetScaler ADM 页面上，选中 成功升级时清理软件映像 复选框以在升级后删除映像文件。 选择此选项会在升级时自动删除 NetScaler ADM 映像文件。

    笔记

    默认情况下选择此选项。 如果在开始升级过程之前未选中此复选框，则必须手动删除图像。

    选择升级文件

  4. 然后，您可以通过选择 Local （您的本地机器）或 Appliance来上传新的图像文件。 构建文件必须存在于 NetScaler ADM 虚拟设备上。

  5. 单击 确定。

  6. 升级 ADM 页面显示一些详细信息，例如文件名、选定的版本、预计完成时间。 点击 升级。

    升级

    升级过程开始。

迁移配置后，您可以登录 ADM GUI。 登录后，历史数据开始在后台迁移，同时您可以继续使用 ADM。

13-0-67-x 首次登录

在历史数据迁移期间，一些旧数据可能不可用。 迁移数据库所需的时间取决于数据的大小和表的数量。

您可以使用 ADM GUI 监控数据库迁移。 单击 查看升级进度 ，然后出现 数据库迁移状态 。

13-0-67-x 首次登录

升级完成后，您可以看到默认免费许可证减少到两个的消息。 单击 查看详细信息 了解更多信息。

升级后

将单个 NetScaler ADM 服务器升级到 13.1-4.x 或 13.1-9.x

  1. 使用管理员凭据登录 NetScaler ADM。

  2. 导航到 系统 > 系统管理。 在 系统管理 子标题下，单击 升级 NetScaler ADM。

    升级 NetScaler ADM

  3. 在 升级 NetScaler ADM 页面上，选中 成功升级时清理软件映像 复选框以在升级后删除映像文件。 选择此选项会在升级时自动删除 NetScaler ADM 映像文件。

    笔记

    默认情况下选择此选项。 如果在开始升级过程之前未选中此复选框，则必须手动删除图像。

    选择升级文件

  4. 然后，您可以通过选择 Local （您的本地机器）或 Appliance来上传新的图像文件。 构建文件必须存在于 NetScaler ADM 虚拟设备上。

    上传图片

  5. 单击 确定。 系统弹出“确认”对话框。 点击 是。

    升级过程开始。

迁移配置后，您可以登录 ADM GUI。 登录后，历史数据开始在后台迁移，同时您可以继续使用 ADM。

13-0-67-x 首次登录

在历史数据迁移期间，一些旧数据可能不可用。 迁移数据库所需的时间取决于数据的大小和表的数量。

您可以使用 ADM GUI 监控数据库迁移。 单击 查看升级进度 ，然后出现 数据库迁移状态 。

13-0-67-x 首次登录

解决数据库迁移问题

在升级到 13.1 xx.xx 及更高版本的过程中，Web Insight 历史数据的迁移有时可能会出现停滞。 在这种情况下，要检查数据迁移的详细信息，请执行以下操作。

登录 ADM shell 提示符并运行以下命令来查看进度的详细信息。


    猫/var/mps/log/db_upgrade/web_insight_mapping_migration_status

<!--NeedCopy-->

以下是示例输出

    bash-3.2# cat /var/mps/log/db_upgrade/web_insight_mapping_migration_status
    2020 年 10 月 6 日星期二 07:41:55 GMT
    127346 个中的 157 个在 54 秒内完成
    文件
     /var/mps/db_upgrade/hist_table_mig_data/Web_Insight/af_app_client_server_resp_second_l3p_d7_dump
    bash-3.2#

 <!--NeedCopy-->

在这个例子中， af_app_client_server_resp_second_l3p_d7 是正在升级的条目。 127,346 个条目中的 157 个条目在 54 秒内完成迁移。

将高可用性对从 12.1 版本升级到 13.1 版本

对于高可用性模式下的 NetScaler ADM 服务器，您可以通过访问活动节点或浮动 IP 地址进行升级。 一旦您在任一服务器中启动升级过程，两个 NetScaler ADM 服务器都会自动升级到最新版本。

升级 NetScaler ADM 灾难恢复部署

升级 NetScaler ADM 灾难恢复部署分为两步：

升级 NetScaler ADM 灾难恢复节点

  1. 从 NetScaler 站点下载 NetScaler ADM 升级映像文件。

  2. 使用 nsrecover 凭据将此文件上传到灾难恢复节点。

  3. 使用 nsrecover 凭据登录到灾难恢复节点。

  4. 导航到放置图像文件的文件夹并解压缩该文件。

  5. 运行以下脚本：

    ./安装

    升级 dr agent2

升级本地代理以实现多站点部署

升级 NetScaler 代理部署分为三个步骤。 升级本地代理之前，请确保已完成以下任务：

  1. 升级高可用性部署的 NetScaler ADM 服务器。

  2. 升级 NetScaler ADM 灾难恢复节点。

    有关详细信息，请参阅 升级 NetScaler ADM 灾难恢复部署。

升级本地代理

  1. 从 NetScaler 站点下载 NetScaler 代理升级映像文件。

  2. 使用 nsrecover 凭据将此文件上传到代理节点。

  3. 确保您下载了正确的代理升级映像。

  4. 使用 nsrecover 凭据登录到本地代理。

  5. 导航到放置图像文件的文件夹并解压缩该文件。

    升级 dr agent3

  6. 运行以下脚本：

    ./安装masagent

    升级 dr agent4

向 NetScaler ADM 服务器添加额外的磁盘

如果您的 NetScaler ADM 存储要求超出默认磁盘空间 (120 GB)，您可以附加一个额外的磁盘。 您可以在单服务器和高可用性部署中附加更多磁盘。

将 NetScaler ADM 从发行版本 12.1–13.1Œ 升级时，您在早期版本中的附加磁盘上创建的分区保持不变。 分区未被删除或调整大小。

在升级版本中，连接更多磁盘的过程保持不变。 现在，您可以使用 NetScaler ADM 中的新磁盘分区工具在新添加的磁盘中创建分区。 您还可以使用该工具来调整现有更多磁盘中的分区大小。 有关如何连接更多磁盘和使用新磁盘分区工具的更多信息，请参阅 如何将额外的磁盘连接到 NetScaler ADM。

使用 StyleBooks 在 OpenStack 中配置 NetScaler 实例

从 NetScaler ADM 12.1 build 49.23 开始，OpenStack 编排工作流的架构已更新。 工作流程现在使用 NetScaler ADM StyleBooks 来配置 NetScaler 实例。 如果从版本 12.0 或 12.1 build 48.18 升级到 NetScaler ADM 13.1，则必须运行以下迁移脚本：

/mps/scripts/migration_scripts/migrate_configurations.py
<!--NeedCopy-->

有关 os-cs-lb-mon StyleBook 和迁移脚本的更多信息，请参阅 使用 StyleBook 在 OpenStack 上配置 NetScaler VPX 实例