layout-3 - NVIDIA 文档layout-6 - NVIDIA 文档layout-1 - NVIDIA 文档layout-top - NVIDIA 文档
NVIDIA 文档中心chevron_right NVIDIA 网络chevron_right 网络软件chevron_right 管理软件chevron_right

NVIDIA NetQ

layout-top - NVIDIA 文档layout-6 - NVIDIA 文档layout-1 - NVIDIA 文档

升级 Cumulus Linux

生命周期管理 (LCM) 允许您通过 NetQ UI 或 CLI 升级网络中一台或多台交换机上的 Cumulus Linux。您可以通过调度“升级作业”来完成此操作，这些作业会升级交换机上的 Cumulus Linux。每个作业最多可以升级 50 台交换机上的 CL。NetQ 每次升级 5 台交换机，直到升级作业中的所有交换机都升级完成。您可以最多同时调度 5 个升级作业运行。

对于运行 Cumulus Linux 版本的部署

  • 5.6.0 到 5.8.0：如果您的环境运行的是 NetQ 4.10.1 或更高版本，则可以升级到 Cumulus Linux 版本 5.9 或更高版本。如果您运行的是早期版本的 NetQ，则必须先升级 NetQ，然后再升级 Cumulus Linux。
  • 5.0.1 到 5.7.0：您可以升级到 Cumulus Linux 版本 5.8。

云部署必须运行 NetQ v4.11 或更高版本才能执行此页面上概述的步骤。

要升级到 Cumulus Linux 5.9 或更高版本

  1. 确保您的交换机已配置 NVUE。
  2. 使用 NVUE 配置交换机的主机名。
  3. 使用 nv config save 命令保存所有配置。

当您升级未使用 NVUE 配置的交换机（仅支持升级到 Cumulus Linux 版本 5.8 及更早版本）时，LCM 会备份和恢复 Cumulus Linux 中的平面文件配置。在您升级了使用平面文件管理的交换机并随后运行 NVUE 配置命令后，NVUE 将覆盖 NetQ LCM 恢复的配置。有关更多信息，请参阅升级 Cumulus Linux和使用 NVUE CLI 进行系统配置。

在 Cumulus Linux 升级过程中，NetQ 不会升级或重新安装不属于 Cumulus Linux 镜像的软件包。例如，如果您在交换机上安装了 node_exporter 软件包，则必须在升级完成后重新安装这些软件包。

准备 Cumulus Linux 升级

在升级之前，请确保您拥有适当的文件和凭据

  1. 上传 Cumulus Linux 升级镜像。

如果您要升级到 Cumulus Linux 5.9 或更高版本，并选择回滚到以前的 Cumulus Linux 版本（对于不成功的升级尝试）的选项，则必须将总共四个 netq-apps 和 netq-agents 软件包上传到 NetQ。Cumulus Linux 5.9 或更高版本的软件包包含 cld12。早期版本的 Cumulus Linux 包含 cl4u。

例如，您必须为 amd64 架构上传以下软件包

  • netq-agent_4.12.0-cl4u49~1731404368.ffa541ea6_amd64.deb
  • netq-apps_4.12.0-cl4u49~1731404368.ffa541ea6_amd64.deb
  • netq-agent_4.12.0-cld12u49~1731404238.ffa541ea6_amd64.deb
  • netq-apps_4.12.0-cld12u49~1731404238.ffa541ea6_amd64.deb

  1. （可选）指定默认升级版本。

  2. 验证或添加交换机访问凭据。

  3. （可选）为每台交换机分配角色，以识别交换机依赖关系并避免潜在的升级问题。

升级 Cumulus Linux

如果您要升级的交换机上已安装 NetQ 代理，请按照以下步骤操作。如果您要升级的交换机上未安装 NetQ 代理，请运行交换机发现以查找当前已安装和未安装 NetQ 的所有 Cumulus Linux 交换机，并在发现工作流程中执行 CL 升级。

  1. 展开 菜单，然后选择 管理交换机。

  2. 在交换机管理选项卡中，找到“交换机”卡片，然后单击管理。

  3. 选择您要升级的交换机。

  4. 单击 升级操作系统（位于表格上方）。

    按照 UI 中的步骤操作。输入升级的名称并查看您选择要升级的交换机

screen displaying 2 switches selected for upgrading

如果您不小心包含了您不想升级的交换机，请将鼠标悬停在交换机信息卡上，然后单击 删除 以将其从升级中移除。

  1. 单击下一步。

  2. 指定 NetQ 在升级期间应使用的 Cumulus Linux 版本。如果您之前上传了 NetQ 镜像，您也可以在此次升级 NetQ。

  3. 验证或添加交换机访问凭据。

  4. 单击下一步。

  5. 验证升级作业选项。

    默认情况下，NetQ 会对任何升级失败的服务器执行回滚到原始 Cumulus Linux 版本。它还在升级前后拍摄网络快照。

您可以通过单击来从快照中排除选定的服务和协议。必须包含节点和服务。

  1. 单击下一步。

  2. NetQ 执行多项检查，以消除升级过程中可预防的问题。当所有预检查都通过时，单击预览。

  3. NetQ 将引导您到一个屏幕，您可以在其中查看升级。查看后，选择开始升级并确认。

使用 netq lcm upgrade cl-image 命令执行升级，提供升级作业的名称、Cumulus Linux 和 NetQ 版本，以及要升级的主机名的逗号分隔列表

cumulus@switch:~$ netq lcm upgrade cl-image job-name upgrade-example cl-version 5.9.1 netq-version 4.12.0 hostnames spine01,spine02

创建网络快照

您还可以通过向命令添加 run-snapshot-before-after 选项，在升级前后生成网络快照

cumulus@switch:~$ netq lcm upgrade cl-image job-name upgrade-example cl-version 5.9.1 netq-version 4.12.0 hostnames spine01,spine02,leaf01,leaf02 order spine,leaf run-snapshot-before-after

在升级失败时恢复

（推荐）如果升级作业失败，您可以通过向命令添加 run-restore-on-failure 选项来恢复 Cumulus Linux 的先前版本。

cumulus@switch:~$ netq lcm upgrade cl-image name upgrade-example cl-version 5.9.1 netq-version 4.12.0 hostnames spine01,spine02,leaf01,leaf02 order spine,leaf run-restore-on-failure

预检查失败

如果一项或多项预检查失败，请解决相关问题并重新开始升级。在 NetQ UI 中，这些失败会出现在“升级预览”页面上。在 NetQ CLI 中，它以错误消息的形式出现在 netq lcm show upgrade-jobs cl-image 命令输出中。

分析结果

开始升级后，您可以在 NetQ UI 中监控进度。成功的升级用绿色勾号 表示。失败的升级会显示指示失败原因的错误消息。

  • 要使用 CLI 查看当前升级作业的进度和先前升级作业的历史记录，请运行 netq lcm show upgrade-jobs cl-image。
  • 要查看特定升级作业的详细信息，请运行 netq lcm show status job-ID。
  • 要仅查看 Cumulus Linux 升级作业，请运行 netq lcm show status cl-image job-ID。

成功升级后，您可以

后检查失败

成功升级后仍可能存在后检查警告。例如，您更新了操作系统，但并非所有服务在升级后都完全启动并运行。如果一项或多项后检查失败，则警告消息将显示在预览的“升级后任务”部分。单击警告类别以查看详细消息。

    版权所有 © 2025  NVIDIA 公司