产品文档
NetScaler Console
14.1-当前版本 13.1
查看 PDF

升级

December 18, 2025
投稿者: 
C 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. 导航到 Settings > Administration。在 System Maintenance 下，单击 Upgrade NetScaler ADM。

    升级 NetScaler ADM

  3. 在 Upgrade NetScaler ADM 页面上，选中 Clean software image on successful upgrade 复选框，以在升级后删除映像文件。选择此选项会在升级后自动删除 NetScaler ADM 映像文件。

    注意

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

    选择升级文件

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

  5. 单击 OK。

  6. Upgrade ADM 页面显示文件名称、所选版本、预计完成时间等详细信息。单击 Upgrade。

    升级

    升级过程开始。

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

13-0-67-x 首次登录

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

您可以使用 ADM GUI 监控数据库迁移。单击 View upgrade progress，将显示 Database Migration Status。

13-0-67-x 首次登录

升级完成后，您可以查看默认免费许可证减少到两个的消息。单击 View Details 以获取更多信息。

升级后

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

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

  2. 导航到 System > System Administration。在 System Administration 副标题下，单击 Upgrade NetScaler ADM。

    升级 NetScaler ADM

  3. 在 Upgrade NetScaler ADM 页面上，选中 Clean software image on successful upgrade 复选框，以在升级后删除映像文件。选择此选项会在升级后自动删除 NetScaler ADM 映像文件。

    注意

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

    选择升级文件

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

    上传映像

  5. 单击 OK。

    将显示“Confirm”对话框。单击 Yes。

    升级过程开始。

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

13-0-67-x 首次登录

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

您可以使用 ADM GUI 监控数据库迁移。单击 View upgrade progress，将显示 Database Migration Status。

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 18, 2025
投稿者: 
C C
December 18, 2025
投稿者: 
C C

在本文中

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