WilliamLam.com

  • About
    • About
    • Privacy
  • VMware Cloud
  • Tanzu
    • Application Modernization
    • Tanzu services
    • Tanzu Community Edition
    • Tanzu Kubernetes Grid
    • vSphere with Tanzu
  • Home Lab
  • Nested Virtualization
  • Apple
You are here: Home / Automation / VMware Cloud Foundation with a single ESXi host for Management Domain?

VMware Cloud Foundation with a single ESXi host for Management Domain?

02.21.2023 by William Lam // 2 Comments

By default, VMware Cloud Foundation (VCF) requires a minimum of 4 ESXi hosts to construct the Management Domain which is fine for a production environment, but it can be a challenge for those interested in explore VCF in a homelab setting.

I recently came to learn about a really cool tidbit from one of our VCF Engineers on how you can actually deploy a VCF Management Domain using just a single ESXi host, ideal for a homelab setup! 😍


Not only could this benefit users in deploying a physical VCF setup but it would also benefit anyone using my Automated Lab Deployment Script for VCF, which makes it super easy by leveraging my Nested ESXi Virtual Appliance VMs.


In fact, that was how I quickly verified this trick works using my VCF automation script 😀

The way that this work is a configuration change to Cloud Builder to tell it to allow a single ESXi host to be used and it will simply setup a single node vSAN Cluster, which is typically how you would bootstrap if you were doing a greenfield deployment. The only difference here is that instead of adding additional 3 x ESXi hosts to provide redundancy for Management Domain, it simply is relaxing that requirement and thus allowing for a single ESXi host. vSAN is still a requirement for VCF Management Domain, so ensure you can meet those requirements still.

Disclaimer: This is not supported by VMware, use at your own risk. As of writing this blog post, this trick is functional with the latest VCF 4.5 release.

Step 1 - Before starting a VCF deployment, SSH to the Cloud Builder VM and run the following commands:

echo "bringup.mgmt.cluster.minimum.size=1" >> /etc/vmware/vcf/bringup/application.properties
systemctl restart vcf-bringup.service

This will take a minute or so for the VCF Bringup service to restart and if you are logged into the Cloud Builder UI, you may see a blue notification banner asking you to refresh.

Note: You will also know that the setting has been applied correctly when you specify only a single ESXi host as it should not complain that you are not meeting the minimum 4 host requirement.

Step 2 - We need to generate a VCF deployment using the JSON format. If you are using my VCF automation script, it will automatically generate the required JSON deployment file upon completing the deployment and and you can go straight to Step 3. If you are starting with the VCF Deployment XLSX workbook, then please see this blog post on how to convert the file from XLSX to JSON before proceeding to Step 3.

Step 3 - Edit the VCF JSON configuration file and ensure it only contains a single ESXi host entry as shown in the example below:

"hostSpecs": [{
    "hostname": "vcf-m01-esx01",
    "vSwitch": "vSwitch0",
    "association": "sfo-m01-dc01",
    "credentials": {
        "username": "root",
        "password": "VMware1!"
    },
    "ipAddressPrivate": {
        "subnet": "255.255.255.0",
        "ipAddress": "192.168.30.182",
        "gateway": "192.168.30.1"
    }
}]

Next, append following entry "hostFailuresToTolerate": 0 within the clusterSpec section as shown in the example below

"clusterSpec": {
    "vmFolders": {
        "MANAGEMENT": "sfo-m01-fd-mgmt",
        "NETWORKING": "sfo-m01-fd-nsx",
        "EDGENODES": "sfo-m01-fd-edge"
    },
    "clusterName": "sfo-m01-cl01",
    "clusterEvcMode": "",
    "hostFailuresToTolerate": 0
},

Step 3 - Finally, we are now ready to begin our VCF deployment and provide our modified VCF JSON configuration as input to the VCF deployment wizard.


Once the VCF pre-checks have successfully completed without errors, you can begin the deployment by clicking next. Deployment times will vary based on the available resources and hardware configuration.

As you can see, while I can get away with just 54GB of memory for my single ESXi VM, it was definitely tight on resources and you may want to provision at least 60-64GB of memory. If you plan to also deploy a VCF Workload Domain, you will need to assign additional resources to accommodate those requirements.


Hopefully this makes deploying VCF a bit more easier for folks in a homelab environment and I have few more articles planned this week on making it easier to deploy VCF in the homelab, so stay tuned!

More from my site

  • VMware Cloud Foundation on Intel NUC?
  • VMware Cloud Foundation with a single ESXi host for Workload Domain?
  • Removing NSX CPU/Memory reservations when deploying a VMware Cloud Foundation (VCF) Management or Workload Domain
  • Quick Tip - Convert VMware Cloud Foundation (VCF) Deployment Workbook XLSX to JSON
  • Quick Tip - Inventory core count for vSphere+, vSAN+ & VCF+ Cloud Service

Categories // Automation, ESXi, Home Lab, NSX, VMware Cloud Foundation, VSAN, vSphere Tags // VMware Cloud Foundation

Comments

  1. wardvissers says

    02/21/2023 at 12:31 pm

    Nice! Gone try it!

    Reply
  2. Joe Houghes @*protected email* (@jhoughes) says

    02/22/2023 at 6:58 am

    Nice, thanks for the share. This will definitely help for some lab work.

    Reply

Thanks for the comment! Cancel reply

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

Search

Author

William Lam is a Senior Staff Solution Architect working in the VMware Cloud team within the Cloud Infrastructure Business Group (CIBG) at VMware. He focuses on Cloud Native technologies, Automation, Integration and Operation for the VMware Cloud based Software Defined Datacenters (SDDC)

Connect

  • Email
  • GitHub
  • LinkedIn
  • RSS
  • Twitter
  • Vimeo

Recent

  • Changing the default HTTP(s) Reverse Proxy Ports on ESXi 8.0 03/22/2023
  • Quick Tip - How to download ESXi ISO image for all releases including patch updates? 03/15/2023
  • SSD with multiple NVMe namespaces for VMware Homelab 03/14/2023
  • Is my vSphere Cluster managed by vSphere Lifecycle Manager (vLCM) as a Desired Image or Baseline? 03/10/2023
  • Interesting VMware Homelab Kits for 2023 03/08/2023

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 © 2023

 

Loading Comments...