产品文档
Application Delivery Management
14.1 - Current Release 13.1 13.0
查看 PDF

升级

December 11, 2025
投稿者: 
C

每个 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 之前需要注意的事项：

  • 如果您从版本 11.1 或版本 12.0 56.x 及更早版本升级，请执行以下步骤：

    1. 从现有版本升级到 12.0 build 57.24。

    2. 升级到 12.1 版本的最新 build。

    3. 升级到版本 13.1。

  • 如果您从 12.0 build 57.24 及更高版本升级，请首先升级到 12.1，然后再升级到 13.1。

  • 如果您从 12.1 升级，则可以直接升级到 13.1。

  • 如果您从低于 13.0 64.xx 的版本升级，为了获得更好的用户体验，请首先升级到 13.0 64.xx，然后再升级到 13.1。

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

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

注意

不支持降级 ADM 软件。请勿尝试降级。

建议的预防措施：

  • 如果您要升级到 13.1 xx.xx 及更高版本，请拍摄 NetScaler ADM 服务器的快照。

  • 在升级之前备份 NetScaler® ADM 服务器。

  • 升级后，您可能需要重新建立 NetScaler ADM 服务器与托管实例之间的连接。确认提示会警告您，如果继续操作，连接可能会失败。

  • 如果您升级到 13.1.9.x 到 13.1.30.x 之间的任何版本，NetScaler ADM 会将现有 StyleBooks ConfigPacks 回滚到其早期版本。

    为避免此问题，请升级到 13.1.33.50 build。

  • 对于高可用性设置中的 NetScaler ADM 服务器，在升级时，请勿对任一节点进行任何配置更改。

    警告

    在升级过程成功完成之前，请勿刷新浏览器。请查看 GUI 以了解升级完成的大致时间。

  • 升级后，高可用性对中的活动节点可能会发生变化。

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

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

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

    升级 NetScaler ADM

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

    注意

    此选项默认处于选中状态。如果您在开始升级过程之前未选中此复选框，则必须手动删除映像。

    选择升级文件

  4. 然后，您可以通过选择“本地”（您的本地计算机）或“设备”来上传新的映像文件。build 文件必须存在于 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. 然后，您可以通过选择“本地”（您的本地计算机）或“设备”来上传新的映像文件。build 文件必须存在于 NetScaler ADM 虚拟设备上。

    上传映像

  5. 单击“确定”。将显示“确认”对话框。单击“是”。

    升级过程开始。

配置迁移后，您可以登录到 ADM GUI。登录后，历史数据将在后台开始迁移，同时您可以继续在 ADM 上工作。

13-0-67-x 首次登录

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

您可以使用 ADM GUI 监控数据库迁移。单击“查看升级进度”，将显示“数据库迁移状态”。

13-0-67-x 首次登录

数据库迁移问题排查

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

登录到 ADM shell 提示符，然后运行以下命令以查看进度的详细信息。


    cat /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
    Tue Oct  6 07:41:55 GMT 2020
    157 out of 127346 done in 54 seconds
    File
     /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 服务器都会自动升级到最新 build。

升级 NetScaler ADM 灾难恢复部署

升级 NetScaler ADM 灾难恢复部署是一个两步过程：

  • 升级主站点中配置为高可用性模式的 NetScaler ADM 节点。稍后，您必须升级灾难恢复节点。

  • 在升级灾难恢复节点之前，请确保您已升级部署在高可用性模式下的 NetScaler ADM 服务器。

升级 NetScaler ADM 灾难恢复节点

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

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

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

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

  5. 运行以下脚本：

    ./installmas

    升级 DR 代理 2

升级多站点部署的本地代理

升级 NetScaler 代理部署是一个三步过程。在升级本地代理之前，请确保您已完成以下任务：

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

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

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

升级本地代理

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

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

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

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

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

    升级 DR 代理 3

  6. 运行以下脚本：

    ./installmasagent

    升级 DR 代理 4

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

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

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

在升级后的 build 中，附加更多磁盘的过程保持不变。您现在可以使用 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 实例。

升级
December 11, 2025
投稿者: 
C
December 11, 2025
投稿者: 
C

在本文中

站点反馈 | Your privacy choices footer link您的隐私选择 | 隐私和法律条款 | Cookie 首选项 | 同意设置 | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.