"Host did not have any virtual network defined" error when redeploying NSX Edge VM

Products

• VMware NSX

Issue/Introduction

• Edge redeployment is in a "Deployment Failed" state with error
  
  Ovf deploy for vm <VM name> failed on vc <VC name> : Host did not have any virtual network defined.
  
  
  
  
• On the NSX Manager log, /var/log/proton/nsxapi.log
  
  <DATE>T10:47:18.398Z ERROR ActivityWorkerPool-1-9 OvfDeploy 77726 SYSTEM [nsx@6876 comp="nsx-manager" errorCode="MP40409" level="ERROR" subcomp="manager"] Ovf deploy failed for vm <VM name> on vc <vCenter name> with error 'Host did not have any virtual network defined.'

Environment

VMware NSX

Resolution

This is a known issue impacting VMware NSX when the Edge VM was originally deployed on a legacy release.

The issue can be resolved by temporarily adding a standard switch portgroup called "VM Network" on each host in the vSphere cluster.
This is a dummy portgroup/switch, no real NICs or networking is required.

The steps below assume a standard switch does not already exist, if it does the new portgroup can be added to it.

1. On the vSphere client, select one of the ESXi host > Configure > Networking > Virtual Switches > click on ADD NETWORKING
2. Under "Select connection type" select the option "Virtual Machine Port Group for a Standard Switch" > Next
3. Under "Select target device" if a standard switch already exists use that otherwise select "New standard switch" > Next
4. Under "Crete a Standard Switch" section do not select any physical network adapter and click on Next. Click on "OK" for the no physical network adapter warning
5. Under "Connection Settings" Update the Network label as "VM Network" > Next
6. Under "Ready to complete" click on Finish.