Edge Node Status Degraded or Down After TEP Interface Modification

Products

• VMware NSX

Issue/Introduction

After adding or modifying Tunnel Endpoint (TEP) interfaces on an Edge Node, all the Edge nodes status may change to Down or Degraded.

Executing the "get dataplane" command on the Edge Node where the TEP changes were applied results in the following error message:

% An unexpected error occurred: The dataplane service is in error state, has failed, is disabled, or Maintenance mode is Enabled

Environment

VMware NSX

Cause

This issue may occur when the Edge Node is under heavy load, processing dataplane traffic at the time TEP tunnel interface changes are applied.

Resolution

To resolve the issue:

Check if the NSX Edge Node is placed in "NSX Maintenance Mode". This can be validated from NSX UI and Edge CLI.

NSX UI :

Navigate to System > Fabric > Nodes > Edge Transport Nodes.
If the "Configuration State" of the NSX Edge Node shows as "NSX Maintenance Mode", proceed with exiting the Edge from "NSX Maintenance Mode".
Select the NSX Edge Node. Click on dropdown of ACTIONS and select "Exit NSX Maintenance Mode".

The below snippet shows NSX Edge Node in "NSX Maintenance Mode".



Edge CLI :

Run the "get maintenance-mode" command to validate the status of Maintenance Mode.

edge> get maintenance-mode
Mon Mar 03 2025 UTC 05:56:11.830
Maintenance Mode: enabled

The above command snippet shows the Edge in "NSX Maintenance Mode" as Maintenance Mode is enabled.

Run the command below from Edge admin mode to trigger an exit of NSX edge maintenance mode.

edge> set debug-mode
edge> set maintenance-mode disabled

Example of command execution :

edge> set debug-mode
edge> set maintenance-mode disabled
This command has been deprecated and not recommended for use. Please use API/UI to configure this setting.
Are you sure you want to continue? (yes/no):yes
Maintenance Mode: disabled

If the Edge Node is not in "NSX Maintenance Mode", follow the below steps.

1. Run the following command on the affected Edge Node to restart the dataplane service:

restart service dataplane

2. After the service restarts, verify that the dataplane is operational by executing:

get dataplane

Ensure the command returns valid output without errors.

3. Confirm that the Tunnel Endpoint (TEP) interface assignment is correct by running:

get host-switches