文档目录

升级管理节点 HA 环境

本任务适用于已设置管理节点 HA 的 ZSphere 环境。

  • 执行本任务前,请先完成 升级前准备。
  • 请在维护窗口内执行升级。升级期间需要停止两端管理服务,且高可用套件升级默认会重启两端数据库,管理界面和管理服务将暂时不可用。
Note: 生产环境升级前,建议联系售后技术支持,确认升级方案及相关注意事项。
  1. 获取 VIP 所在管理节点 IP 地址。
    执行以下命令获取 VIP 所在管理节点 IP 地址,返回结果中 VIP 为 yes 的节点即为 VIP 所在的管理节点:
    [root@localhost ~]# zsha2 status
  2. 解压高可用套件,并赋予可执行权限。
    在 VIP 所在管理节点依次执行以下命令,解压高可用套件,并对 zsha2 和 zstack-hamon 文件赋予可执行权限:
    # 解压高可用套件
    [root@localhost ~]# tar zxvf ZStack-ZSphere-Multinode-HA-Suite.tar.gz
    
    # 赋予可执行权限
    [root@localhost ~]# chmod +x zsha2 zstack-hamon
  3. 停止两端管理节点服务。
    分别登录两个管理节点,执行以下命令停止管理服务:
    [root@localhost ~]# zsha2 stop-node
  4. 升级高可用套件。
    在 VIP 所在管理节点的套件解压目录执行以下命令:
    [root@localhost ~]# ./zsha2 upgrade-ha
    Note:
    • 请确保两端管理服务均已停止,否则无法继续升级。
    • gencfg 参数默认为 true,无需额外指定。升级时会更新两端数据库配置,并重启两端 MariaDB。
    • 若显式指定 -gencfg=false,将跳过数据库配置更新及对应的 MariaDB 重启,依赖配置更新的修复也不会生效。常规升级建议使用上述命令,不指定此参数。
  5. 执行 zsha2 version 命令检查 commit id 是否与最新版本包中的一致。
  6. 升级 ZStack-ZSphere。
    在 VIP 所在管理节点执行以下命令,升级虚拟化平台:
    zsha2 upgrade-mn -peerpass password ZStack-ZSphere-x86_64-DVD-5.2.0-H84r.iso
    Note: -peerpass 为可选参数,可设置 Peer 管理节点 SSH 登录密码。
升级完成后,请继续执行 平台升级后检查与处理。