Edge Node Removal Fails with Error Code 10026 Referencing Logical DHCP Server

Products

• VMware NSX Networking

Issue/Introduction

When attempting to remove an Edge node from a cluster, the following error is displayed:

[Routing] Entity PolicyEdgeNode/.../edge-nodes/{edge_node_id} cannot be deleted as it is being referenced by entity(s): LogicalDhcpServer/{dhcp_server_id} (Error code: 10026)

 

Environment

VMware NSX

Cause

The Edge node cannot be removed because Logical DHCP Servers are still pinned to the Edge node.
Even if logical routers are evacuated and the Edge is placed in maintenance mode, DHCP references prevent node removal.

Resolution

Steps to Resolve

1. Validate DHCP Dependency

   • SSH to the Edge node being deleted.

   • Run: get dhcp leases

   • Confirm if any active leases exist.

2. Relocate DHCP Servers

   • Navigate to Networking → Network Profiles → DHCP.

   • Enable Standby Relocation for the DHCP server.

   • Note: Relocation may take up to 30 minutes. More info on this here Remove NSX Edge Nodes from an Edge Cluster

   • If the service does not get relocated automatically manually relocate the service in the cluster.

3. Retry Edge Removal

   • Once DHCP services are moved, attempt to remove the Edge node from the cluster.

Additional Information

• Related KB: How to delete Edge Transport Nodes using API (KB 345813)