问题说明

本文用于排查“V2V 迁移 / Windows 启动卡住”类问题。

适用环境

• 产品：ZCF
• 组件：Cloud
• 涉及对象：V2V/Windows启动
• 版本：4.x、5.x
• 场景：V2V 迁移 / Windows 启动卡住

问题现象

• 云主机启动失败、反复重启、进入系统失败或报 libvirt/qemu 错误。

可能原因

• 镜像启动模式、磁盘链、backing file、RBD watchers、云盘路径、驱动或迁移后系统兼容问题。

排查步骤

1. 记录 VM uuid、rootVolume/dataVolume uuid、hostUuid、报错原文和任务时间。
2. 检查 management-server、kvmagent、libvirt/qemu 日志。
3. 核对镜像启动模式、磁盘链、主存储状态和云盘文件是否存在。

关键命令

virsh list --all
grep -a -nE "<vmUuid>|libvirt|qemu|backing|watchers|Could not open|not a bootable" /usr/local/zstack/apache-tomcat/logs/management-server.log* /var/log/libvirt/qemu/*.log 2>/dev/null

解决方案

• 按排查结果修复对应组件、配置、数据状态或链路问题。
• 若涉及数据库、底层存储、快照链、云主机磁盘、GPU 直通或管理服务重启，先确认备份、影响面和回滚路径。

验证方法

• 复核本文所述现象是否消失。
• 平台 UI、API、管理节点日志和底层命令输出能够相互印证。
• 至少观察一个相关任务周期或告警周期，确认问题不再复现。

风险与回滚

• 生产环境执行修复前必须确认客户业务影响、变更窗口和回滚方案。
• 涉及数据删除、数据库修改、快照链修复、底层文件处理和硬件操作时，建议联系 ZStack 官方技术支持确认。

注意事项

• 涉及云主机启动、迁移、HA、Unknown 状态或强制停止时，必须先确认云主机实际运行位置，防止脑裂、双写或误停业务。
• 若需要数据库修改、底层文件处理、锁释放、服务重启、驱动/固件升级或批量资源变更，应联系 ZStack 官方技术支持确认后再执行。