文档目录

适用场景

  • 产品:ZCF
  • 组件:ZCE-X
  • ZCE-X 版本:6.4.x
  • 存储节点:多节点存储集群
  • 触发条件:当前存储 UI 未显示预期标识,需要更新前端包修复。

问题现象

  • 存储 UI 未显示预期标识。
  • 需要通过更新前端 rpm 包使页面标识恢复正常。
  • 变更要求不影响存储服务本身。

判断方法

  1. 更新前登录各节点 UI,确认当前可正常访问且健康状态正常。
  2. 更新后重新登录 UI,确认页面标识显示恢复正常。
  3. 更新前后都执行 ceph -s,确认集群保持 HEALTH_OK。

原因说明

问题集中在前端 UI 包,需要更新前端包使页面标识恢复正常,不影响存储服务本身。

解决方案

  1. 执行前准备
  • 风险等级:低风险
  • 先检查所有存储节点与 UI 健康状态。
  • 逐节点执行更新,先完成第一台验证,再继续后续节点。
  1. 处理步骤
  2. 登录各存储节点的 UI,确认健康状态正常:
  • <存储节点管理地址>:8056/
  • 预期结果:页面可访问、健康状态正常。
  1. SSH 登录存储节点并检查 Ceph 状态:
   ceph -s
  • 预期结果:显示 HEALTH_OK。
  1. 在目标存储节点上传前端 rpm 包:
   ZSTACK-V6-XSCALEROS_6.4.200.1-0.el7.centos.noarch.rpm
  • 预期结果:目标安装包已上传到节点。
  1. 执行更新:
   rpm -U --force <rpm包>
  • 预期结果:前端包升级完成。
  1. 重新登录该节点的存储 UI,确认页面标识显示恢复正常。
  • 预期结果:UI 标识显示恢复正常。
  1. 再次执行:
   ceph -s
  • 预期结果:存储集群依然为 HEALTH_OK。
  1. 按相同步骤逐节点更新其余存储节点。
  • 预期结果:所有存储节点的 UI 前端均更新完成。

验证方法

  • 检查各存储节点的 8056 页面可正常访问。
  • 检查页面标识显示恢复正常。
  • 检查每次更新后 ceph -s 均保持 HEALTH_OK。

风险与回滚

  • 风险:若首台节点前端更新失败,需立即停止后续节点更新。
  • 风险等级:低。
  • 回滚:无具体 rpm 回退命令,但明确指出前端 UI 更新不影响存储服务;实际执行中若首台失败,应停止继续扩散。
ZCE-X 存储 UI 标识显示异常修复 | 技术方案 · KB | ZStack 资源中心