NSX Edge node upgrade fails with an error "Overall status of the edge transport node is DOWN"
search cancel

NSX Edge node upgrade fails with an error "Overall status of the edge transport node is DOWN"

book

Article ID: 371343

calendar_today

Updated On: 07-14-2025

Products

VMware NSX

Issue/Introduction

  • One of the NSX edge node upgrade fails 
  • Overall status of the edge transport node <UUID of the Edge node> is DOWN
  • Tunnel status of the edge transport node is down
  • Fast path adapters(fp-ethX) link status on the edge node is down, OR
  • There is underlay network issue (Layer 2 or Layer 3) because of which the TEP communication is DOWN.
  • Upgrade status gives the error message similar to the one below

    Overall status of the edge transport node <UUID> is DOWN.,Tunnel status of the edge transport node 52ba####-####-####-####-####888b03a0 is DOWN.,Edge node <UUID> , has errors Errors = [{"moduleName":"upgrade-coordinator","errorCode":30212,"errorMessage":"Overall status of the edge transport node <UUID>"}, {"moduleName":"upgrade-coordinator","errorCode":30209,"errorMessage":"Tunnel status of the edge transport node <UUID> is DOWN."}, ] after state sync wait.



Environment

VMware NSX

Cause

This error can occur if the fast path adapters on the NSX edge nodes are down during the upgrade.

OR

There is a underlay network connectivity issue for the tunnel traffic, which can be verified from packet captures on the edge tunnel interface.  Refer this on how to take packet captures on the NSX edge node.

Resolution

Run the command get phy fp-eth0 from the nsx edge node admin cli to check the status of the fast path adapters. 

edge-01> get phy fp-eth0 
Physical Port 
ADMIN_STATUS : up <----------------- should be "up" 
DRIVER : net_vmxnet3 
DUPLEX : full 
ID : 0 
LINK : up <----------------- should be "up" 


To resolve the issue, make sure all the network adapters on the edge node are connected and the status is UP and the underlay communication (L2/L3) between the TEPs should be working fine.