文档目录

问题说明

VMTools普通安装流程需要把ISO挂载到虚拟光驱。若用户安装OS后删除的是整个光驱设备而非只卸载ISO,页面检查到 vmCdRoms为空后会阻止安装。

现象

  • 页面提示“虚拟机缺少光驱,请添加新光驱后再执行此操作”或同义文本。
  • VM详情中没有CD-ROM设备。
  • 关键区分点:是“没有光驱设备”,不是“光驱存在但ISO未挂载”。

适用环境

ZSphere 4.10.26和5.1.0已验证;Windows/Linux普通ISO安装路径均可能遇到。

可能原因

先在页面或只读API inventory确认光驱设备数量。只有设备为空时才按本篇;光驱存在仍报错,应检查页面缓存、API inventory和VM XML一致性。

问题定性

  • 类型:操作问题/产品防呆场景。
  • 已知问题:是;ZSV-12079 Closed/Won't Do,5.1.0已验证页面会提示;ZSV-12082 Closed/Duplicate,评论确认4.10.26存在。
  • 根因:用户删除了整个虚拟光驱,VMTools ISO没有挂载目标。
  • 置信度:高,前提是 inventory确认光驱列表为空。

排查步骤

检查一:页面确认硬件设备

  • 只读路径:云主机详情 → 配置信息/虚拟机硬件 → 光驱。
  • 没有任何光驱:命中本篇。
  • 有空光驱或已挂载ISO:不能判定为“缺少光驱”,收集页面和API证据升级人工。

检查二:确认近期操作

  • 只读路径:云主机审计/操作日志,搜索删除光驱、卸载ISO、安装VMTools。
  • 记录显示删除CD-ROM设备:根因闭环。
  • 仅显示卸载ISO:设备理论上仍应存在,需核对 inventory。

检查三:确认VM运行状态和变更条件

  • 只读检查:VM状态、当前任务、是否允许在线添加光驱。
  • 运行状态不支持添加:需审批关机窗口。
  • 存在快照/备份/其他任务:等待任务结束,不应并发修改硬件。

处理建议

Note:

本节操作须由具备权限的管理员人工执行。

由客户在维护窗口进入 VM硬件配置添加一个空光驱,保存后重新执行安装VMTools。若运行状态不允许添加,按业务审批关机后添加再启动。变更前记录原硬件清单;若添加失败,撤销新设备并提交日志。不要把“卸载ISO”和“删除光驱”混为一步。

长期方案

保留产品的缺光驱提示和操作防呆;文档明确安装OS后只卸载ISO,不删除CD-ROM设备。

补充信息

升级人工条件

  • 页面显示已有光驱但仍提示缺少。
  • 添加光驱失败或需要停机但无维护窗口。
  • ISO挂载成功后安装仍失败。

需要收集的信息

ZSphere/Guest OS版本、VM硬件页面、光驱inventory、操作审计、VM状态、安装报错截图和VM UUID(脱敏提交)。

相关问题

  • ZSV-12079,Closed/Won't Do。
  • ZSV-12082,Closed/Duplicate。
  • 状态核验日期:2026-08-06。
安装 VMTools 时提示云主机缺少光驱 | 故障排查 · KB | ZStack 资源中心