# vSphere 集群服务 (vCLS)
> [!question] vCLS 是什么
> - vCLS 是 vSphere 7.0 U1 新功能, 确保 [[vsphere-drs|vSphere DRS]] 集群服务在 vCenter 故障期间仍正常工作
> [!question] 能否禁用 vCLS 功能
> - 如未使用 [[vsphere-drs|vSphere DRS]] 功能, 可在集群级别禁用 vCLS 功能 [[#1 使用撤退模式禁用 vCLS 功能|>>]]
> [!question] vCLS 虚拟机对运维操作影响
> - vCLS 虚拟机视为系统虚拟机, 由 vCenter 内部服务自动管理
> - 在维护 ESXi 主机操作中 vCLS 虚拟机自动开关机
> - 在 [[maintain-vsan-cluster|使用命令和内置脚本维护 vSAN 集群]] 操作中需要提前启用撤退模式
## 1 使用撤退模式禁用 vCLS 功能
- 适用于 vSphere 7.0 U3o+, 8.0 U2+
- [[vsphere-client|vSphere Client]] -> `<cluster>` -> 配置 -> vSphere Cluster Services - General
- 适用于 vSphere 7.0 U1+, 使用 [KB91890](https://knowledge.broadcom.com/external/article?legacyId=91890) 脚本
- `python retreatModeConfiguration.py -r enable` (启用撤退模式, 禁用 vCLS 功能)
> [!warning] 慎用编辑 vpxd.cfg 方式启用撤退模式, 误编辑将导致 vCenter 服务不可用 [KB83383](https://knowledge.broadcom.com/external/article?legacyId=83383)
## 2 MWAIT 缺失导致 vCLS 虚拟机无法启动问题
- 症状
- 缺少功能 "MWAIT"， 但此功能必须存在，无法启动虚拟机
- ...
- 原因
- vCLS 虚拟机默认启用 Per-VM EVC 隐藏特性
- 该特性要求服务器 BIOS 启用 Monitor/MWait, 但部分服务器机型默认未启用该特性
### 2.1 解决办法
- 在服务器 BIOS 启用 Monitor/MWait 特性
> [!tip] 启用 Monitor/MWait 后重启服务器检查是否生效
> - 部分服务器型号启用 Monitor/MWait 需要同时调整性能 Profile, 否则重启失效
### 2.2 临时解决办法 #1 禁用 vCLS 虚拟机 Per-VM EVC 隐藏特性
> [!tip] 该办法在 vCLS 虚拟机重新部署时需要再次配置
1. 暴露 vCLS 虚拟机 Per-VM EVC 功能
- 查看 vCLS 虚拟机所在主机, 登陆 [[esxi-ui|ESXi Host Client]]
- 右击 vCLS 虚拟机 - 升级虚拟机硬件兼容性至版本 14 或以上
2. 禁用 Per-VM EVC 功能
- 登陆 [[vsphere-client|vSphere Client]], 点击 vCLS 虚拟机 - 配置 - VMware EVC - 编辑 - 禁用 (可能灰显, 需等待 5 分钟左右)
3. 等待 vCLS 虚拟机自动启动, 或在 [[esxi-ui|ESXi Host Client]] 启动 vCLS 虚拟机
- vCLS 虚拟机成功开机后会继续部署下一台, 每个集群最多 3 台
4. 在每台 vCLS 虚拟机执行以上步骤
### 2.3 临时解决办法 #2 禁用 vCLS 功能
> [!tip] 如未使用 [[vsphere-drs|vSphere DRS]] 功能, 可在集群级别禁用 vCLS 功能 [[#1 使用撤退模式禁用 vCLS 功能|>>]]
---
> [!info] 本页面永久链接 https://fillgaps.pro/vsv-references/vsv-features/vsphere-vcls
> [!info] 本页面最新 [PDF](https://file.fillgaps.pro/vsphere-vcls_2404v1.pdf) 和 [Web](https://file.fillgaps.pro/vsphere-vcls_2404v1.mht) 下载
> [!info] 本页面如有纠正或补充建议, 请发[邮件](mailto:
[email protected])或公众号私信
---
<!--- [[vsphere-cluster-service|vSphere Clustering Service (vCLS)]]
- cpuid.mwait absent cause vCLS VMs fail to power on issue
- #Symptoms
- #Cause
- *"vCLS VMs are by default deployed with a "_per VM EVC_" mode that expects the CPU to provide the flag cpuid.mwait."*
- #Impact
- *"==HA== and DRS cannot be enabled if the vCLS VMs cannot power on."*
- #Resolution
- *"enable Monitor/MWAIT in the BIOS of the ESXi"*
- #Workaround
- Workaround #1
- Workaround #2 Disable
- See more
- [vSphere Cluster Services (vCLS) in vSphere 7.0 Update 1 and newer versions (80472)](https://knowledge.broadcom.com/external/article?legacyId=80472)
-
- RH2288H V5 -->
<!--
[[Internal] vSphere Cluster Services VMs powers off/on unexpectedly (91623)](https://ikb.vmware.com/s/article/91623?lang=en_US)
[DRS 功能受 vSphere 集群服务 (vCLS) 的不正常状态影响 (79892)](https://ikb.vmware.com/s/article/79892?lang=zh_CN)
-->
## 3 参考资源
- VMware 文档 [[vsv-docs-contents|>>]]
- [vSphere 集群服务](https://docs.vmware.com/cn/VMware-vSphere/8.0/vsphere-vcenter-esxi-management/GUID-96BD6016-4BE7-4B1C-8269-568D1555B08C.html)
- VMware 知识库 [[vsv-kb-contents|>>]]
- [vSphere Cluster Services (vCLS) in vSphere 7.0 Update 1 and newer versions (80472)](https://knowledge.broadcom.com/external/article?legacyId=80472)
- vSphere 7.0 Update 1 中的 vSphere 集群服务 (vCLS) (80472)
- [How to Disable vCLS on a Cluster via Retreat Mode (91890)](https://knowledge.broadcom.com/external/article?legacyId=91890)
- [vCLS VMs fail to power on with an error message "Insufficient resources" in vSphere 7.0 Update 1 or newer (83076)](https://knowledge.broadcom.com/external/article?legacyId=83076)
- 在 vSphere 7.0 Update 1 或更高版本中，vCLS 虚拟机无法打开电源，并显示错误消息“资源不足 (Insufficient resources)” (83076)
- [vCenter is down after wrong configuration for vcls and reboot. (83383)](https://knowledge.broadcom.com/external/article?legacyId=83383)
- [vSphere Cluster Services (vCLS) Known Issues/Corner Cases (91891)](https://knowledge.broadcom.com/external/article?legacyId=91891)