文档目录

问题说明

本文用于排查“ZSphere 安装系统无法识别硬盘或 RAID 卡驱动未适配”类问题。

现象

  • 安装 ZSphere 时无法识别硬盘。
  • 新华三服务器安装时报 Failed to start udev wait for complete。
  • 故障 RAID 卡需要初始化虚拟磁盘后才能继续启动。

适用环境

  • 产品:ZVF
  • 版本:4.10.10
  • 组件:ZSphere
  • 涉及对象:安装部署
  • 场景:主机与硬件类问题,需结合当前版本、部署形态、存储类型和操作时间线确认。

可能原因

  • 当前 ZSphere ISO 未内置目标 RAID 卡驱动。
  • RAID 卡虚拟磁盘未初始化或控制器状态异常。
  • 服务器硬件型号较新,需联系 ZStack 官方技术支持确认适配驱动或定制 ISO。

排查步骤

按顺序执行以下检查,并记录受影响对象、发生时间、完整报错和当前状态。

  1. 记录服务器型号、RAID 卡型号、固件版本和 ZSphere ISO 版本。
  2. 在 BIOS/RAID 管理界面确认虚拟磁盘已初始化且状态健康。
  3. 使用安装介质前先确认该硬件是否在当前版本适配列表中。
  4. 缺少驱动时,收集硬件信息并联系 ZStack 官方技术支持确认适配驱动或定制 ISO;不要自行替换驱动。

处理方法

  1. 在 BIOS/RAID 管理界面确认虚拟磁盘初始化完成且状态健康。
  2. 使用与当前硬件和内核版本匹配的受支持驱动或安装介质;适配关系未确认时,由 ZStack 官方技术支持提供处理建议。

验证方法

  • 安装程序可以识别目标虚拟磁盘。
  • 安装完成后,系统可正常启动且存储控制器运行稳定。
ZSphere 安装系统无法识别硬盘或 RAID 卡驱动未适配 | 故障排查 · KB | ZStack 资源中心