HCX Bulk migration validation fails with an error "Gateway not provided for the Primary NIC! Not all the networks are mapped"

Products

• VMware HCX

Issue/Introduction

• HCX migration validation is failing with the error: "Gateway not provided for the Primary NIC! Not all the networks are mapped."
• In HCX, the VM appears to have two network adapters.
• However, in vCenter, the VM is showing only one network adapter.

Environment

VMware HCX

Cause

• The VM has an existing snapshot that contains old network configuration (e.g., from a standard port group).
• While trying to migrate the VM to a distributed switch port group.
• Because the snapshot still holds the old network settings of previous disk states, HCX detects two sets of network adapter information one from the snapshot and one from the new configuration.
• This mismatch causes HCX to show two network adapters for the VM and results in a migration validation failure error.

VM connected to standard port group and running snapshot.

VM migrated to distributed port group

HCX UI: While performing Bulk migration validation shows two network adapters with validation error

 

 

Resolution

1. Check if the VM has any existing snapshots before starting the migration.
2. If a snapshot exists, Delete the Snapshot to remove any old network configuration.
3. Rerun the HCX migration validation to ensure its successful.

Additional Information

Sometimes, if the VM is running on stale snapshot disks, those snapshot will not appear in snapshot manager tab on the VM.
To further confirm, Right click on the VM --> Edit Settings --> Expand the Hard disk of VM --> The VM disk is found pointing to a snapshot disk file such as VM-Name-00000#.vmdk

In such scenarios, as a workaround, you need to take a new snapshot, and then perform Snapshot Deletion task again. To know more details, refer to the KB Stale snapshots in the datastore on which the virtual machine resides