Search the VMware Knowledge Base (KB)
View by Article ID

VXLAN datapath instance fails after upgrading to ESXi 5.5 (2083299)

  • 0 Ratings


  • After upgrading to ESXi 5.5, the VXLAN datapath fails to work on the upgraded host.
  • VXLAN datapath fails to work. 
  • Virtual machines running on the upgraded host are not in a connected state.
  •  Attempting to connect the virtual machine fails with the error:

    Failed to connect virtual device ethernet0


This issue occurs if the VXLAN kernel module does not initialize properly and the overlay property is set before the VXLAN/vdl2 module is loaded. In this case, the data place does not work.


This issue is resolved in VMware NSX for vSphere 6.2, available at VMware Downloads. For more information, see the NSX for vSphere 6.2.0 Release Notes.

If you are unable to upgrade to VMware NSX for vSphere 6.2, follow this workaround.

To identify the issue:
  1. Log in to the ESXi host with the root account using SSH.
  2. Run this command:

    net-vdl2 -l

    You see output similar to:

    # net-vdl2 -l
    VXLAN Global States:
    Control plane Out-Of-Sync: No
    UDP port: 8472
    VXLAN VDS: Compute-DVS
    VDS ID: 37 aa 00 50 ad 73 97 0d-d1 0f 5c 28 40 c2 84 5b
    MTU: 1600
    Segment ID:
    Gateway IP:
    Gateway MAC: 00:00:5e:00:01:03
    Vmknic count: 0
    VXLAN vmknic: vmk1
    VDS port ID: 146
    Switch port ID: 50331656
    Endpoint ID: 0
    VLAN ID: 0
    Segment ID:
    IP acquire timeout: 0
    Multicast group count: 0
    Network count: 0

    The output does not show the VTEP vmknic being used by VXLAN (the Vmknic count would list 0 VTEP vmknics).

To work around the issue:

  1. Set the affected ESXi host in the maintenance mode.
  2. Reboot the ESXi host.
  3. Run the net-vdl2 -l command. The output should now list the VXLAN VTEP vmknic interface.

Note: This also applies when upgrading vCloud Network and Security 5.5 to NSX 6.0.

Additional Information

To be alerted when this article is updated, click Subscribe to Document in the Actions box.

See Also

Request a Product Feature

To request a new product feature or to provide feedback on a VMware product, please visit the Request a Product Feature page.


  • 0 Ratings

Did this article help you?
This article resolved my issue.
This article did not resolve my issue.
This article helped but additional information was required to resolve my issue.

What can we do to improve this information? (4000 or fewer characters)

Please enter the Captcha code before clicking Submit.
  • 0 Ratings