NSX-V to NSX-T Migration fails during Config Translation with error: "Cannot find VTEP portgroup on overlay dvs"

Products

• VMware NSX

Issue/Introduction

During an NSX-V to NSX-T migration using the Migration Coordinator, the Configuration Translation phase fails at 0% completion. The migration process stops because the system cannot identify a valid VTEP portgroup on the Distributed Virtual Switch (DVS).

The following error messages are observed in the logs:

migrate-coordinator.log / translation.log: [Host Switch Profiles] Can not proceed with migration: Cannot find VTEP portgroup on overlay dvs <vds_name>

cm.log:  Host <Hostname> has a VTEP vmk6 connected to dvportgroup_name with VLAN X, but its cluster has VXLAN configured with VLAN Y. Please remove the VTEP and retry migration.

Environment

VMware NSX-T Data Center

Cause

The issue is caused by a mismatch between the VXLAN configuration at the cluster level and the actual portgroup configuration on the vSphere Distributed Switch.

In this scenario, the cluster-wide VXLAN settings were configured to use a specific VLAN (e.g., VLAN 1003), but the VMkernel interface (VTEP) used for VXLAN traffic was connected to a portgroup configured with "None" or VLAN X(e.g., VLAN 0). The Migration Coordinator fails the validation check because it cannot reconcile the host's actual network state with the defined VXLAN transport parameters.

Resolution

To resolve this issue, the required VTEP portgroup on overlay dvs <vds_name> should be made available.