升级 NetQ 虚拟机

本页介绍如何升级您的 NetQ 虚拟机。请注意，升级说明因您当前运行的 NetQ 版本而异。

对于正在运行的部署

• 4.11、4.10.1：直接升级到 NetQ 4.12
• 4.10.0 或更早版本：备份您的 NetQ 数据并执行全新安装

在升级过程中，NetQ 将暂时不可用。

升级前须知

1. 验证 Kubernetes 正在运行且 admin 应用程序已启动

cumulus@masternode:~$ /home/cumulus# kubectl get pods|grep admin
    netq-app-admin-masternode                            1/1     Running            0               15m

如果此命令的输出显示错误或返回空响应，您将无法升级 NetQ。请尝试等待，然后重新运行该命令。如果多次尝试后命令仍然失败，请使用 netq bootstrap reset keep-db 重置 NetQ 服务器，并使用适合您部署类型的netq install命令全新安装 tarball。有关更多信息，请参阅“NetQ 安装和升级问题故障排除”。

2. 备份您的 NetQ 数据。对于本地部署，这是一个可选步骤。NVIDIA 会自动为 NetQ 云部署创建备份。

更新 NetQ Debian 软件包

1. 将 /etc/apt/sources.list.d/cumulus-netq.list 更新为 netq-4.12

   cat /etc/apt/sources.list.d/cumulus-netq.list
   deb [arch=amd64] https://apps3.cumulusnetworks.com/repos/deb focal netq-4.12
   

2. 更新 NetQ debian 软件包。在集群部署中，更新主节点和所有工作节点上的软件包

   cumulus@<hostname>:~$ wget -qO - https://apps3.cumulusnetworks.com/setup/cumulus-apps-deb.pubkey | sudo apt-key add
   cumulus@<hostname>:~$ sudo apt-get update
   Get:1 https://apps3.cumulusnetworks.com/repos/deb focal InRelease [13.8 kB]
   Get:2 https://apps3.cumulusnetworks.com/repos/deb focal/netq-4.12 amd64 Packages [758 B]
   Hit:3 http://archive.ubuntu.com/ubuntu focal InRelease
   Get:4 http://security.ubuntu.com/ubuntu focal-security InRelease [88.7 kB]
   Get:5 http://archive.ubuntu.com/ubuntu focal-updates InRelease [88.7 kB]
   ...
   Reading package lists... Done
   

   cumulus@<hostname>:~$ sudo apt-get install -y netq-agent netq-apps
   Reading package lists... Done
   Building dependency tree
   Reading state information... Done
   ...
   The following NEW packages will be installed:
   netq-agent netq-apps
   ...
   Fetched 39.8 MB in 3s (13.5 MB/s)
   ...
   Unpacking netq-agent (4.12.0-ub20.04u49~1731404061.ffa541ea6) ...
   ...
   Unpacking netq-apps (4.12.0-ub20.04u49~1731404061.ffa541ea6) ...
   Setting up netq-apps (4.12.0-ub20.04u49~1731404061.ffa541ea6) ...
   Setting up netq-agent (4.12.0-ub20.04u49~1731404061.ffa541ea6) ...
   Processing triggers for rsyslog (8.32.0-1ubuntu4) ...
   Processing triggers for man-db (2.8.3-2ubuntu0.1) ...
   

下载升级软件

1. 下载升级 tarball。

   1. 在NVIDIA 应用程序中心，登录您的帐户。
      
   2. 选择“NVIDIA 许可门户”。
   3. 从菜单中选择“软件下载”。
   4. 点击“产品系列”，然后选择“NetQ”。
   5. 为您的虚拟机监控程序选择相关软件
      如果您要为本地 NetQ VM 升级 NetQ 软件，请选择“NetQ SW 4.12.0 Appliance”以下载 NetQ-4.12.0.tgz 文件。如果您要为云 NetQ VM 升级 NetQ 软件，请选择“NetQ SW 4.12.0 Appliance Cloud”以下载 NetQ-4.12.0-opta.tgz 文件。
   6. 如果出现提示，请阅读许可协议并继续下载。

   对于企业客户，如果您在 NVIDIA 应用程序中心 看不到“NVIDIA 许可门户”的链接，请联系 NVIDIA 支持。

   
   

   对于 NVIDIA 员工，请直接从 NVIDIA 许可门户 下载 NetQ。

2. 将 tarball 复制到您的 NetQ VM 上的 /mnt/installables/ 目录。

运行升级

安装前检查

在升级 NetQ 之前，请验证以下项目。

1. 确认您的 VM 配置了 16 个 vCPU。如果您的 VM 配置的 vCPU 少于 16 个，请关闭 VM 电源，重新配置您的虚拟机监控程序以分配 16 个 vCPU，然后打开 VM 电源后再继续。对于集群部署，请在集群中的每个节点上验证这些要求。

2. 检查是否有足够的磁盘空间

cumulus@<hostname>:~$ df -h /
Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1       248G   70G  179G  28% /
cumulus@netq-appliance:~$

NVIDIA 建议仅在“使用率%”低于 70% 时才继续安装。您可以删除 /mnt/installables/ 目录中以前的软件 tarball 以回收一些空间。如果您无法将磁盘使用率降低到 70% 以下，请联系 NVIDIA 支持团队。

3. 确认 NetQ CLI 已正确配置。netq show agents 命令应成功完成并显示代理状态。

4. 确保根据您的部署模型打开必要的端口。

使用 NetQ CLI 升级

1. 运行适合您部署类型的命令

cumulus@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-4.12.0.tgz

cumulus@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-4.12.0.tgz

cumulus@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-4.12.0-opta.tgz

cumulus@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-4.12.0-opta.tgz cluster-vip <vip-ip>

2. 确认升级成功

```
cumulus@<hostname>:~$ cat /etc/app-release
BOOTSTRAP_VERSION=4.12.0
APPLIANCE_MANIFEST_HASH=c664236fb1d732b3633ab83662575c35f397bc6ac3a9970632523827097c8415
APPLIANCE_VERSION=4.12.0
APPLIANCE_NAME=NetQ On-premises Appliance
```

```
cumulus@<hostname>:~$ cat /etc/app-release
BOOTSTRAP_VERSION=4.12.0
APPLIANCE_MANIFEST_HASH=370ffbe3195aa1c4cc969668441b124e7714f7eaa980962ff4cc438fcec31b87
APPLIANCE_VERSION=4.12.0
APPLIANCE_NAME=NetQ cloud Appliance
```

后续步骤

• 升级 NetQ 代理