WilliamLam.com

  • About
    • About
    • Privacy
  • VMware Cloud Foundation
  • VKS
  • Homelab
    • Resources
    • Nested Virtualization
  • VMware Nostalgia
  • Apple
You are here: Home / Automation / Incorrect guestOS type for Nested ESXi causes vCLS issues with VMware Cloud Foundation (VCF) Holodeck Toolkit

Incorrect guestOS type for Nested ESXi causes vCLS issues with VMware Cloud Foundation (VCF) Holodeck Toolkit

07.03.2024 by William Lam // Leave a Comment

Several months back, I started noticing an increase number of folks reporting problems powering on their vSphere Cluster Services (vCLS) VM when using the VMware Cloud Foundation (VCF) Holodeck Toolkit solution and the following workaround can be applied, which came directly from the Holodeck developers.

While a workaround exists including vCLS script located at C:\VLC\VLC-Holo-Site-1\vclsfix, it was very puzzling because this seems to only happen with the Nested ESXi VMs and the VCF Holodeck Toolkit and it was NOT observed when deploying a regular Nested ESXi environment, but I never took a closer look to see why that might be.

A few weeks back, I recieved an email from Mike Foley (former vSphere HA and vCLS PM), I came to learn the reason folks using the VCF Holodeck Toolkit was seeing this problem and it was specific to that solution due to how the guestOS was configured for the Nested ESXi VMs.

Instead of using the ESXi guestOS type, the VCF Holodeck Toolkit was deploying the Nested ESXi VM using the "Other (64-Bit) and this is problematic because there are only two guestOS types that have the MWAIT instruction enabled by default, one of which is the ESXi guestOS type and the other is for Apple macOS. This is why vCLS VMs (which are running "Nested") are having problems powering on due to required MWAIT instruction and hence some additional workarounds are required.


In a correctly configured Nested ESXi configuration (such as using my Nested ESXi Virtual Appliances), the guestOS type is specified correctly and hence you will not have any issues powering on the vCLS VMs when you deploy your Nested ESXi environment. The good news is that the developers of VCF Holodeck Toolkit is now aware of this issue and this will be fixed in a future update, so no additional workaround will be required.

If you wish to fix the issue with VCF Holodeck Toolkit, you can manually update the VLCGui.ps1 script and search for "otherGuest64" and replace it with the desired ESXi identifier (use vmkernel8Guest for VCF 5.x and later) listed below:

ESXi Version GuestOS Identifier
ESXi 8.x vmkernel8Guest
ESXi 7.x vmkernel7Guest
ESXi 6.7 & 6.5 vmkernel65Guest

More from my site

  • vSAN ESA HCL hardware mock VIB for Nested ESXi
  • Using Nested ESXi for VMware Cloud Foundation (VCF) Workload Domain fails with vSAN ESA Auto Disk Claim 
  • ESXi on GMKtec NucBox K11
  • Quick Tip - VMware Cloud Foundation (VCF) Bringup fails without persistent ESX-OSData
  • Enable TRIM/UNMAP from Nested vSAN OSA/ESA to physical vSAN OSA

Categories // Automation, ESXi, Nested Virtualization Tags // Nested ESXi, vCLS, VMware Cloud Foundation

Thanks for the comment!Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

Search

Thank Author

Author

William is Distinguished Platform Engineering Architect in the VMware Cloud Foundation (VCF) Division at Broadcom. His primary focus is helping customers and partners build, run and operate a modern Private Cloud using the VMware Cloud Foundation (VCF) platform.

Connect

  • Bluesky
  • Email
  • GitHub
  • LinkedIn
  • Mastodon
  • Reddit
  • RSS
  • Twitter
  • Vimeo

Recent

  • Programmatically accessing the Broadcom Compatibility Guide (BCG) 05/06/2025
  • Quick Tip - Validating Broadcom Download Token  05/01/2025
  • Supported chipsets for the USB Network Native Driver for ESXi Fling 04/23/2025
  • vCenter Identity Federation with Authelia 04/16/2025
  • vCenter Server Identity Federation with Kanidm 04/10/2025

Advertisment

Privacy & Cookies: This site uses cookies. By continuing to use this website, you agree to their use.
To find out more, including how to control cookies, see here: Cookie Policy

Copyright WilliamLam.com © 2025

 

Loading Comments...