Edge node redeployment fails with registration pending due to disabled IPv4 assignment

Products

• VMware NSX

Issue/Introduction

When redeploying or adding edge nodes, one node may deploy successfully while another remains stuck in a Registration Pending state and eventually enters maintenance mode. Upon checking the console of the affected node, it is observed that the node is not receiving an IP address. 

Environment

VMware NSX

Cause

The deployment payload for the affected edge node contains an incorrect configuration where IPv4 assignment is explicitly disabled (ipv4 assignment disabled: true). This prevents the node from obtaining the necessary IP address to complete the registration process with the management plane.

Resolution

To resolve this issue, you must correct the configuration payload and re-trigger the deployment.

• Identify the configuration difference between a working node and the non-working node by reviewing the deployment API payloads.
• Locate the parameter ipv4 assignment disabled in the payload of the failing node.
• Update the value to false (or ensure it is correctly enabled) to allow IPv4 assignment.
• Execute the API call to redeploy the edge node using the corrected payload.
• Monitor the node via the console and UI to verify it receives an IP address and successfully completes registration.

Additional Information

• If the registration fails initially, you may need to run the redeploy API again to ensure the corrected configuration is fully replicated.