Join NSX Edge Nodes with the Management Plane for Enterprise PKS

Page last updated:

Warning: VMware Enterprise PKS v1.7 is no longer supported because it has reached the End of General Support (EOGS) phase as defined by the Support Lifecycle Policy. To stay up to date with the latest software and security updates, upgrade to a supported version.

This topic provides instructions for joining NSX-T Edge Nodes with the NSX-T Management Plane.


Make sure you have completed all preceding NSX-T installation tasks.

About Joining NSX Edge Nodes with the NSX Management Plane

Joining NSX Edges with the management plane ensures that the NSX Manager and NSX Edges can communicate with each other. For more information, see Join NSX Edge with the Management Plane in the NSX-T Data Center documentation.

Join NSX Edge Nodes with the NSX-T Management Plane

To register an Edge Node with NSX Manager, complete the following procedure:

  1. Open an SSH session to one of the NSX-T Manager VMs, such as nsx-manager-1.

    • For example, if you are using Unix: ssh admin@IP_ADDRESS_OF_NSX_MANAGER-1
    • If you are using Windows, use Putty to SSH to the NSX-T Manager node
  2. Open another SSH session to the target NSX Edge Node VM, such as nsx-edge-1.

  3. On the NSX-T Manager appliance, run the command get certificate api thumbprint.

    The command output is a string of alphanumeric numbers that is unique to this NSX Manager. For example:

    nsx-manager-1> get certificate api thumbprint
  4. On the NSX-T Edge Node VM, run the following command to register the Edge Node with the NSX Management Plane.

    join management-plane <nsx-manager-ip-address> username <username> thumbprint <nsx-manager-api-thumbprint>

    For example:

    join management-plane username admin thumbprint 120a129d533601a6...210243d6d6bce8f8f0d84d66d
  5. When prompted, enter the admin password for the NSX-T Manager.

  6. Verify that you see the following output, indicating that the NSX Edge Node is successfully registered.

    Node successfully registered as Fabric Node: 2a8xYdec-aXa7-11x9-9063-0050512345f11
  7. Repeat this join procedure for each NSX Edge Node you have installed for Enterprise PKS.

Verify NSX Edge Node Registration with the NSX Management Plane

To verify Edge Node registration with NSX Manager:

  1. Verify Edge Node registration by running the command get managers on the NSX Edge Node.

    You should see that the Edge Node is connected to one of the NSX Manager nodes. For example:

    nsx-edge-1> get managers
    - 10.XXX.XX.144    Standby
    - 10.XXX.XX.145    Connected
    - 10.XXX.XX.143    Standby
  2. In NSX Manager, select the page System > Fabric > Nodes > Edge Transport Nodes.

    You should see each registered Edge Node.

    Note: Initially the “Configuration State” is yellow because the Edge Nodes are not configured a NSX-T Transport Nodes. This is done later in the process.

  3. Repeat this verification procedure for each NSX Edge Node you are deploying for Enterprise PKS.

Next Step

See Enable Repository Service on Each NSX Manager Node.

NSX-T Installation Instructions Home

See Installing and Configuring NSX-T for Enterprise PKS.

Please send any feedback you have to