Error: Failed to bootstrap VCF services platform during VCF Management deployment

Products

• VCF Operations
• VMware SDDC Manager / VCF Installer
• VMware vCenter Server

Issue/Introduction

• The task of converging vSphere environment to VCF fails at the Deploy and configure VCF Management Platform stage.
• The VCF Installer UI show the following error message: An error occurred in task "Bootstrap VCF Services Platform". See Tasks panel to learn more.
  

Environment

• VMware Cloud Foundation 9.x 
• VMware vCenter Server 9.x 

Cause

The vCenter is misconfigured with the hostname set to localhost, DNS resolution failure, and duplicate loopback (127.0.0.1) DNS entries present in both /etc/resolv.conf and /etc/systemd/network/10-eth0.network.

Resolution

To resolve this issue, follow the steps below:

Note: Take Snapshot of the vCenter.

1. Resolve vCenter Hostname and DNS Issues:
   
   
   1. Verify that the DNS records (both Forward and Reverse lookup zones) for the vCenter Server are correctly configured and reachable on the DNS server.
   2. Log in to the vCenter Appliance Management Interface (VAMI) using root credentials (https://<vCenter-IP>:5480).
   3. Navigate to Networking > click Edit on the Network Settings.
   4. Update/Change the Hostname to match the FQDN defined in the DNS server. For more information, refer: Update or Change vCenter Server Appliance Hostname/Fully Qualified Domain name (FQDN)/PNID
      
      
2. Remove Duplicate DNS Entries:
   
   
   1. Establish an SSH session to the vCenter Server as root.
   2. Check for duplicate nameserver 127.0.0.1 entries in the /etc/resolv.conf file:
      
      
      cat /etc/resolv.conf

       

      Example output:
      
      

   3. If duplicates exist, remove one entry using following steps:

      • Create a backup: cp /etc/resolv.conf /root/resolv.conf.bak
      • Edit the file: vi /etc/resolv.conf
      • Delete the duplicate line, then save and exit (Esc + :wq!).
        
        
   4. Check the /etc/systemd/network/10-eth0.network file for an additional DNS=127.0.0.1 entry:
      
      
      cat /etc/systemd/network/10-eth0.network
       
      Example output:
      
      
      
      
   5. If the entry is present, remove it using following steps:
      
      
      • Create a backup: cp /etc/systemd/network/10-eth0.network /root/10-eth0.network.bak
      • Edit the file: vi /etc/systemd/network/10-eth0.network
      • Delete the 127.0.0.1 entry, then save and exit (Esc + :wq!).
        
        
   6. Restart the network service to apply changes:
      
      systemctl restart systemd-networkd
      
      
3. Restart VCF Deployment:
   
   • Return to the VCF Installer UI.
   • Locate the failed task and click RETRY AND PROCEED WITH DEPLOYMENT.

Additional Information

This is a VCF Installer known issue See VCF Installer Known Issues for more information.