知识库›技术方案›双管理节点 HA 环境下将 ZStack Cube HCI 升级到 2.4.17

双管理节点 HA 环境下将 ZStack Cube HCI 升级到 2.4.17

技术方案HCI · ZStack Cube HCI适用版本2.0.0 / 2.4.17文章 IDKB-200141更新于2026-09-17

适用场景

产品：ZStack HCI。
原版本：源案例记录为 Cube 2.0.0。
目标版本：Cube 2.4.17。
主存储类型：Ceph。
部署方式：双管理节点 HA。
相关组件：zsha2、zstack-hamon、zstack-upgrade、QEMU、libvirt。

源案例中涉及的 ISO 文件包括：

ZStackCloud-x86_64-DVD-4.8.18-c76.iso
Cube-x86_64-DVD-2.4.17-c76-Enterprise-upgrade-241024.iso

判断方法

本文适用于双管理节点 HA 环境下的计划性 Cube 云平台升级。

执行本文操作前，请确认：

两台管理节点均可访问。
已申请客户认可的维护窗口。
已准备当前版本系统 ISO 和目标版本升级 ISO。
已准备双管理节点 HA 套件。
可通过 IPMI 或其他带外管理方式登录管理节点。

原因说明

本文为计划升级操作手册，并非缺陷处理。源案例中的目标是将 Cube 云平台升级到 Cube 2.4.17。

在双管理节点 HA 环境中，升级前需要确认 VIP 所在节点，并在 VIP 所在管理节点上执行双管理节点 HA 套件升级和云平台升级。同时，需要在两台管理节点上分别完成数据库备份、升级脚本备份和 repo 依赖更新。

解决方案

1. 关闭云主机全局高可用

升级前，请在 UI 中关闭云主机全局高可用，避免维护窗口内意外触发云主机 HA。

UI 路径：

 设置 > 高可用策略

将云主机高可用全局开关设置为 停用。

2. 确认 VIP 所在管理节点

在任意一台管理节点上执行：

zsha2 status

输出中 VIP 显示为 yes 的节点，即为当前 VIP 所在管理节点，也可作为主数据库节点。

3. 备份数据库和升级脚本

在 VIP 所在管理节点上备份数据库，并将备份文件拷贝至 /root/ 目录：

zstack-ctl dump_mysql --file-name zstack-db-backup-master
cp /var/lib/zstack/mysql-backup/zstack-db-backup-master-*.gz /root/

在另一台管理节点上备份数据库，并将备份文件拷贝至 /root/ 目录：

zstack-ctl dump_mysql --file-name zstack-db-backup-slave
cp /var/lib/zstack/mysql-backup/zstack-db-backup-slave-*.gz /root/

分别在两台管理节点上备份升级脚本：

cp /usr/local/bin/zstack-upgrade /root/zstack-upgrade-bak

4. 在两台管理节点上刷新本地 repo 源

分别在两台管理节点上执行以下命令，更新本地 repo 源：

bash zstack-upgrade -r ZStackCloud-x86_64-DVD-4.8.18-c76.iso

等待两台管理节点的 repo 更新完成。

5. 登录 VIP 所在管理节点并准备双管理节点 HA 套件

通过 IPMI 登录 VIP 所在管理节点终端，解压双管理节点 HA 套件：

tar zxvf ZStack-Multinode-HA-Suite.tar.gz

对解压后的 zsha2 和 zstack-hamon 赋予可执行权限：

chmod +x zsha2 zstack-hamon

6. 升级双管理节点 HA 套件

在 VIP 所在管理节点上执行：

./zsha2 upgrade-ha

等待双管理节点 HA 套件升级完成。

7. 升级云平台

在 VIP 所在管理节点上执行：

zsha2 upgrade-mn -peerpass 'rootpassword' /root/zstack-installer.bin

等待云平台升级完成。

8. 按集群升级 QEMU 和 libvirt

云平台升级过程中，会按集群升级 QEMU 和 libvirt 虚拟化组件。

在继续后续操作前，请等待集群级虚拟化组件升级任务完成。

9. 验证资源连接状态

每台物理机均显示已连接。
每个主存储均显示已连接。
云主机实例状态正常。

等待物理机和主存储都连接成功，并确认云主机状态正常后，再继续后续操作。

10. 重新开启云主机全局高可用

确认云主机、物理机和主存储状态均正常后，在 UI 中重新开启云主机全局高可用。

验证方法

升级完成后，确认以下结果：

两台管理节点上执行 zsha2 status，双管理节点 HA 状态正常。
UI 主机列表中每台物理机均处于已连接状态。
UI 主存储列表中每个主存储均处于已连接状态。
云主机实例状态正常。
云主机全局高可用已重新启用。

风险

需要维护窗口。本流程在双管理节点 HA 部署的管理节点上操作。操作期间管理平面可能短暂不可用。请在客户批准的维护窗口内执行，并在升级完成后确认物理机、主存储和云主机状态正常。
升级前必须关闭云主机全局高可用，避免维护窗口内意外触发云主机 HA。
升级前必须备份两台管理节点的数据库和升级脚本，以便异常时恢复。
请确认当前使用的 ISO 文件与现场升级版本一致。