"vCenter Installation failed" when deploying a new VCF domain to ESX hosts with non-default vswitch portgroup names
search cancel

"vCenter Installation failed" when deploying a new VCF domain to ESX hosts with non-default vswitch portgroup names

book

Article ID: 396267

calendar_today

Updated On:

Products

VMware vCenter Server VMware SDDC Manager / VCF Installer VMware vSphere ESXi

Issue/Introduction

Introduction: A vCenter Server installation fails during a new greenfield deployment of VMware Cloud Foundation (VCF). This issue occurs when the virtual machine portgroup name on the destination ESXi host does not match the deployment configuration.

Symptoms:

  • The VCF Installer UI displays: vCenter installation failed.
  • The following error appears at VCF installer appliance in /var/log/vmware/vcf/domainmanager.log: [OPVRKQ] VCF_VSPHERE_VCENTER_INSTALLATION_FAILED vCenter installation failed
  • The  /var/log/vmware/vcf/domainmanager/ci-installer.log contains an OVF Tool mapping error: Error: Invalid target name (VM Network) specified in net mapping. OVF networks: Network 1. Target networks: [VLAN_NAME]

Environment

 VMware Cloud Foundations (VCF) Operations 9.x

Cause

The VCF Installer expects the virtual machine portgroup on ESX to be "VM Network". Changing this before starting a deployment will cause it to fail.

Resolution

  1. Log in to the destination ESX host UI.
  2. Navigate to Networking > Port groups.
  3. Ensure a port group named "VM Network" exists, or modify the deployment configuration parameters to match a valid, existing port group on the host.
  4. Retry the deployment.