1. 升级前准备

1. 阅读目标版本发行说明和兼容性要求；
2. 确认安装包类型是整包还是中间件包；
3. 校验安装包 SHA256；
4. 执行 cmp-ctl backUp 并复制备份到 CMP 主机之外；
5. 记录现有语言、时区、安装路径和 HA JSON；
6. 预留维护窗口。

2. 单节点升级

使用与首次部署一致的参数重新执行安装包：

bash /root/cmp/ZStack-CMP-installer-<新版本>.bin \
  -Izh_CN \
  -TAsia/Shanghai \
  --root-dir /cmp

整包会更新并部署本次发行内置的服务插件；中间件包只更新基础设施，不会自动删除已安装业务插件。

3. HA 升级

当前安装包没有独立的滚动升级流程，不能保证 HA 环境无缝升级。重新执行 --ha 时会停止节点上的 Docker 和现有主 Compose 服务，并重新编排中间件与业务插件，升级期间可能出现页面、API、脚本任务和监控告警暂时不可用。

只有目标版本的发行说明明确支持从当前版本直接升级时，才可在维护窗口内使用原三节点拓扑、VIP 和安装参数执行：

bash /root/cmp/ZStack-CMP-installer-<新版本>.bin \
  -Izh_CN \
  -TAsia/Shanghai \
  --root-dir /cmp \
  --ha /root/cmp-ha.json

该命令属于维护窗口内的整体重新部署，不是无中断滚动升级。不得把安装包当作单节点包分别在三台机器手工执行，也不得在未验证兼容性的情况下跨版本直接升级。目标版本要求经过中间版本或使用专用升级方案时，应严格按照对应版本的升级说明操作。

升级前必须完成外部备份并停止重要业务操作；升级完成后重新执行第五章全部验收项，确认全部服务和 HA 关系正常后再恢复业务访问。

4. 升级后检查

cmp-ctl version
cmp-ctl status
cmp-ctl plugIn
cmp-ctl inspection

HA 环境还应检查 VIP、MariaDB、Redis Sentinel、RabbitMQ 和监控告警集群。