文档目录

适用场景

  • 产品:ZCF
  • 组件:Cloud
  • 版本:5.5.x
  • 部署形态:双管理节点
  • 触发条件:DRS 迁移云主机后出现 GPU 丢失问题,需要通过替换管理节点 jar 包修复。

问题现象

  • 云主机在 DRS 迁移后出现 GPU 丢失。
  • 解决方式依赖同时替换 mevoco-5.5.x.jar 和 drs-5.5.x.jar。
  • 变更本身不影响云主机持续运行,但会涉及管理平台服务重启。

判断方法

  1. 确认问题出现在 DRS 迁移后的 GPU 状态异常。
  2. 替换后检查相关业务与 DRS 行为是否恢复正常。
  3. 确认管理平台服务恢复正常,再重新开启高可用。

原因说明

该问题不是单一配置项异常,而是需要同步替换 mevoco 与 drs 两个核心 jar 包,表明 GPU 丢失问题与迁移编排和相关网络/资源处理逻辑同时有关。

解决方案

  1. 执行前准备
  • 风险等级:高
  • 先关闭平台高可用。
  • 先备份数据库。
  • 双管理节点都要执行停服、备份、替换和重启操作。
  1. 处理步骤
  2. 关闭平台高可用。
  • 预期结果:平台进入可维护状态。
  1. 备份数据库:
   zstack-ctl dump_mysql --file-name 4.x-mn1
   zstack-ctl dump_mysql --file-name 4.x-mn2
  • 预期结果:具备数据库回退基础。
  1. 两台管理节点停止管理服务:
   zsha2 stop-node
  • 预期结果:允许安全替换 jar 包。
  1. 备份原始 jar:
   cp /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/lib/mevoco-5.5.0.jar /root/mevoco-5.5.0.jar.bak
   cp /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/lib/drs-5.5.0.jar /root/drs-5.5.0.jar.bak
  • 预期结果:保留可回退版本。
  1. 替换新 jar:
   cp mevoco-5.5.0.jar /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/lib/mevoco-5.5.0.jar
   cp drs-5.5.0.jar /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/lib/drs-5.5.0.jar
  • 预期结果:修复包覆盖完成。
  1. 修正文件权限:
   chown zstack:zstack /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/lib/drs-5.5.0.jar
   chown zstack:zstack /usr/local/zstack/apache-tomcat/webapps/zstack/WEB-INF/lib/mevoco-5.5.0.jar
  • 预期结果:属主权限正确。
  1. 重启管理服务:
   zsha2 start-node
  • 预期结果:新 jar 生效,平台恢复运行。
  1. 检查业务是否正常,确认无误后开启平台高可用。
  • 预期结果:DRS 迁移 GPU 丢失问题修复完成。

验证方法

  • 检查双管理服务恢复正常。
  • 检查 DRS 迁移后的 GPU 不再丢失。
  • 检查业务运行正常。
  • 检查高可用恢复后平台无异常。

风险与回滚

  • 风险:同时替换两个核心 jar 包,若版本不匹配可能影响管理平台行为。
  • 风险等级:高。
  • 回滚步骤:
  1. 关闭高可用并备份数据库。
  2. 用 /root/mevoco-5.5.x.jar.bak 与 /root/drs-5.5.x.jar.bak 覆盖还原。
  3. 重启管理平台服务并重连物理机。
  4. 重新开启高可用。
DRS 迁移后云主机 GPU 丢失修复补丁 | 产品补丁与更新 · KB | ZStack 资源中心