文档目录

适用场景

  • 产品:ZCF
  • 组件:ZStack Cloud
  • 版本:4.2.x
  • 部署形态:双管理节点
  • 触发条件:需要接入异构 X86 架构的本地备份服务器,但现有管理节点尚未添加对应架构 ISO 的本地源。

问题现象

  • 需要新增异构 X86 架构本地备份服务器。
  • 若管理节点没有对应的异构本地源,平台无法正常添加该备份服务器。
  • 本次变更的核心是给双管理节点补齐对应 ISO repo 源。

判断方法

  1. 变更前先确认 ceph -s 为 OK。
  2. 确认 UI 中服务器状态均为健康。
  3. 确认两台管理节点都已成功添加异构 ISO 本地源。

原因说明

本次问题不在备份服务器本身,而在于管理节点缺少对应架构的本地源。只有先把异构 X86 ISO repo 源添加到双管理节点,平台后续才具备识别和接入该异构备份服务器的条件。

解决方案

  1. 执行前准备
  • 风险等级:中风险
  • 变更前需与 ZStack 官方技术支持确认。
  • 先检查存储和服务器健康状态。
  1. 健康检查
  2. 检查 ceph 集群状态:
  • 预期结果:ceph -s 为 OK。
  1. 检查 UI 中所有服务器状态为健康。
  • 预期结果:当前环境无异常告警。
  1. 备份与添加异构 repo 源
  2. 备份双管理节点数据库:
   zstack-ctl dump_mysql --file-name zstack-db-backup-master
   zstack-ctl dump_mysql --file-name zstack-db-backup-slave
  • 预期结果:具备数据库回退基础。
  1. 将异构 ISO 上传到两台管理节点。
  • 预期结果:ISO 文件已在双管理节点可用。
  1. 在两个管理节点上分别添加不同架构的本地源:
   bash zstack-upgrade -a ZStack-DVD.iso
  • 注意:不同系统、不同异构架构对应的 ISO 名称不一致,实际执行时应替换为对应 ISO 文件名。
  • 预期结果:两台管理节点都成功注册异构本地源。

验证方法

  • 检查 ceph -s 仍为 OK。
  • 检查 UI 中服务器状态仍然健康。
  • 检查异构 X86 本地备份服务器已具备被正常添加的前置条件。

风险与回滚

  • 风险:若在存储或服务器不健康时执行,可能叠加环境风险。
  • 风险:若 ISO 名称填写错误,可能导致异构源添加失败。
  • 风险等级:中。
  • 回滚:无明确回滚命令,执行前应依赖数据库备份作为底线保护。
管理节点添加异构repo源 | 技术方案 · KB | ZStack 资源中心