问题说明
本文用于排查“ZSphere 导入 OVF 模板报上传 session 失效”类问题。
现象
- 导入 OVF 模板时上传中断或报上传 session 失效。
- 同一 VMDK 文件手工检查存在，但 OVF 导入无法继续。
适用环境
- 产品：ZVF
- 版本：4.x, 5.x
- 组件：ZSphere
- 涉及对象：OVF 模板导入
- 场景：模板与工具类问题，需结合当前版本、部署形态、存储类型和操作时间线确认。
可能原因
- OVF 文件内部引用的 VMDK 文件名与实际文件名不一致。
- 模板文件被改名、压缩包解压后文件名大小写变化或存在特殊字符。
- 上传过程中网络中断或 session 超时，但需优先排除模板描述错误。
排查步骤
按顺序执行以下检查，并记录受影响对象、发生时间、完整报错和当前状态。
- 解压模板包，核对 OVF 文件中 File/References 节点引用的 VMDK 名称。
- 确认实际 VMDK 文件名、大小写、扩展名与 OVF 描述完全一致。
- 修正 OVF 引用或恢复原始文件名后重新上传。
- 若仍失败，记录浏览器时间、管理服务日志和上传任务 ID。
处理方法
- 修改 OVF 文件中引用的 VMDK 文件名，使其与实际 VMDK 文件名、大小写和扩展名完全一致；或恢复实际文件名。
- 重新打包模板后再次上传。
验证方法
- OVF 模板可成功上传并完成导入。
- 导入后的模板可正常创建虚拟机，管理服务日志中不再出现上传 session 失效错误。