文档目录

问题说明

本文用于排查“ZSphere 初始化或添加主机因虚拟化未开启失败”类问题。

现象

  • 初始化向导添加主机失败,或添加物理机时报虚拟化相关错误。
  • 嵌套虚拟化环境中添加主机失败,需要 CPU 直通或嵌套虚拟化开关。

适用环境

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

可能原因

  • 物理服务器 BIOS 未开启 Intel VT-x/VMX、AMD SVM 或 VT-d/IOMMU。
  • 虚拟化嵌套部署时,外层虚拟机未启用 CPU 直通或暴露硬件虚拟化能力。
  • 内核模块 kvm_intel/kvm_amd 未正常加载。

排查步骤

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

  1. 在主机执行 lscpu 或 grep /proc/cpuinfo,确认 vmx/svm 标志存在。
  2. 进入 BIOS 开启虚拟化、VT-d/IOMMU,并保存后冷重启服务器。
  3. 嵌套环境需在外层虚拟化平台开启 CPU 直通或嵌套虚拟化。
  4. 重新添加主机前确认 kvm_intel/kvm_amd 模块能正常加载。

处理方法

  1. 物理机进入 BIOS,启用 CPU 虚拟化和 VT-d/IOMMU 功能后保存配置并冷重启服务器。
  2. 嵌套部署环境在外层平台启用 CPU 直通或嵌套虚拟化后,再重新添加主机。

验证方法

  • 主机可识别 vmx 或 svm 虚拟化标志,且 kvm_intel 或 kvm_amd 模块可正常加载。
  • 主机可以成功添加到 ZSphere 集群。
ZSphere 初始化或添加主机因虚拟化未开启失败 | 故障排查 · KB | ZStack 资源中心