适用场景
- 产品：
ZCF - 组件：
ZStack Cloud - 版本：
5.4.x - 操作系统：
H84r - 存储：
XSCALEROS_6.4.x - 部署形态：双管理节点
- 触发条件：当前平台存在本地上传镜像异常问题，需要升级到
5.4.x。
问题现象
- 当前
Cloud 5.4.x环境存在本地上传镜像异常。 - 需要通过平台灰度升级解决该问题。
- 当前 qemu / libvirt 已是最新版本，本次不涉及组件、OS、内核升级。
判断方法
- 升级前通过自检脚本确认环境健康。
- 升级后检查管理节点状态、资源状态和业务正常。
- 检查非核心业务物理机手动重连验证通过，再扩展到全量物理机。
原因说明
本次升级的直接原因，是 Cloud 5.4.x 存在本地上传镜像异常，因此需要升级到 5.4.x。
解决方案
- 升级前准备
- 风险等级：高
- 先执行
zstack-upgrade-check-master自检。 - 关闭全局高可用。
- 申请 1 台非核心业务物理机用于提前重连校验。
- 双管理上传 ISO、升级脚本、HA 组件和 bin，并校验 md5 / commit。
- CLI 调整：
enable.multipath=ignoreconnect.timeout=1200update.os.parallelismDegree cluster=5/10update.os.parallelismDegree host=10- 停止所有云平台备份任务。
- 双管理节点分别备份数据库：
zstack-ctl dump_mysql --file-name 4.x-mn1
zstack-ctl dump_mysql --file-name 4.x-mn2- 灰度升级步骤
- 两个管理节点更新源：
bash zstack-upgrade -r ZStack-Cloud-x86_64-DVD-5.4.7-h84r.iso- 预期结果：repo 更新完成。
- 查询 VIP 节点：
zsha2 status- 预期结果：定位 VIP 所在节点。
- 解压 HA 包并赋权：
tar zxvf Multinode-HA-Suite-zsha2_5.4.0.tar.gz
chmod +x zsha2 zstack-hamon- 预期结果：HA 升级材料就绪。
- 停止双管理节点服务：
zsha2 stop-node- 预期结果：平台进入可升级状态。
- 在 VIP 节点升级 HA：
./zsha2 upgrade-ha -gencfg=true- 预期结果：HA 套件升级完成。
- 升级云平台：
zsha2 upgrade-mn -grayscale -yes -db-root-pw $mysql_root_password -peerpass $peer_mysql_root_password ZStack-Cloud-installer-5.4.7.bin- 预期结果：管理节点升级到
5.4.x。
- 检查状态：
zstack-ctl status
zsha2 status- 预期结果：管理节点状态正常。
- 登录 UI 检查资源状态。
- 先对非核心业务物理机执行手动重连，确认云主机业务正常后，再逐台重连其余物理机。
- 检查 Agent 版本：
zstack-cli QueryAgentVersion- 检查 xsky 存储健康：
ceph -s- 检查云主机网络与业务状态正常。
- 关闭灰度变量：
UpdateGlobalConfig name=grayscaleUpgrade category=upgradeControl value=false- 开启全局高可用。
- 预期结果：平台升级完成并恢复正常运行。
验证方法
- 检查管理节点、物理机、主存储、镜像服务器等资源状态正常。
- 检查非核心业务物理机手动重连验证通过。
- 检查 xsky 存储健康状态正常。
- 检查本地上传镜像问题得到修复。
风险与回滚
- 风险：升级过程中管理节点不可访问，不能申请新资源，也不能调用第三方 API。
- 风险：升级后若浏览器缓存保留旧 UI 静态资源，可能导致域名访问异常，需要用户手动清理浏览器缓存。
- 风险等级：高。
- 回滚：双管理解耦为单管理、恢复旧 repo、重装旧版、恢复数据库后再恢复平台的完整思路。