NSX Edge installation failed with REGISTRATION_TIMEOUT

Products

• VMware NSX

Issue/Introduction

The NSX Manager timeout occurs with the error message below prior to the Edge successfully registering with the manager.

Error encountered: "Error joining the manager, status 500, err: Node registration failed: 'API error retrieving node configuration'"

Environment

VMware NSX

Cause

At the time of NSX Edge deployment, the NSX Edge registration to the NSX Manager fails due to the API Token mismatch.

 

Resolution

Manually register the Edge node with the NSX manager.

Login to Edge Node via ssh/putty as user admin, switch to the root user account by running the command "st en", enter the 'root'password, and, cat /var/log/join_mp.log

In the contents of the file /var/log/join_mp.log, copy the command logged from the line starting with 'cmd' 

root@Edge-Node:~# cat /var/log/join_mp.log
Node successfully registered as Fabric Node: <Edge Node UUID>
Timeout occurred while waiting for edge-service to connect with Manager

cmd: su admin -c  join management-plane  <NSX-Manager-IP>:443 thumbprint <thumbprint>token <obfuscated> node-uuid <Edge-Node-UUID>

 

Step 1:- You can get the thumbprint of the NSX Manager by logging in as admin via ssh/putty and run the command below

get certificate api thumbprint


Step 2:- You can get the token by running the command on NSX Manager via putty/ssh --> admin login --> st en  to switch to root login

curl -X  POST  -sN -k -u   admin:'NSX-Manager-Password'  'https://<NSX-Manager-IP>/policy/api/v1/aaa/registration-token' 

curl -X  POST  -sN -k -u   admin:'NSX-Manager-Password'  'https://<NSX-Manager-IP>/policy/api/v1/aaa/registration-token'
{
  "token" : "#######-####-####-####-#########",
  "roles" : [ "enterprise_admin" ],
  "user" : "admin"

 

Step 3:- To get the Edge node UUID, run the following commands from NSX Manager via putty/ssh --> admin login --> st en  to switch to root login

curl -X GET  -sN -k -u   admin:'NSX-Manager-Password' 'https://<NSX-Manager-IP>/policy/api/v1/transport-nodes'  |grep -i "resource_type\|id\|display_name"  | grep -C 2 <Edge-Node-Hostname>

 

 

Execute the tweaked command at Edge CLI 

root@EdgeNode:~# su admin -c  join management-plane <NSX-Manager-IP>:443 thumbprint <Thumbprint-from-Step-1>  token <Token-from-Step-2> node-uuid <UUID-from-Step-3>