Joining NSX Controllers with the NSX Manager ensures that the NSX Manager and NSX Controllers can communicate with each other.


  • Verify that NSX Manager is installed.

  • Verify that you have admin privileges to log in to the NSX Manager and NSX Controller appliances.


  1. Open an SSH session to NSX Manager.
  2. Open an SSH session to each of the NSX Controller appliances.

    For example, NSX-Controller1, NSX-Controller2, NSX-Controller3.

  3. On NSX Manager, run the get certificate api thumbprint command.
    NSX-Manager> get certificate api thumbprint
  4. On each of the NSX Controller appliances, run the join management-plane command.
    NSX-Controller1> join management-plane NSX-Manager-IP-address username admin thumbprint <NSX-Manager-thumbprint>
    Password for API user: <NSX-Manager-password>
    Node successfully registered and controller restarted

    Run this command on each deployed NSX Controller node.

    Provide the following information:

    • IP address of the NSX Manager with an optional port number

    • Username of the NSX Manager

    • Certificate thumbprint of the NSX Manager

    • Password of the NSX Manager

  5. Verify the result by running the get managers command on your NSX Controllers.
    NSX-Controller1> get managers
    -   Connected
  6. On the NSX Manager appliance, run the get management-cluster status command and make sure the NSX Controllers are listed.
    NSX-Manager> get management-cluster status
    Number of nodes in management cluster: 1
    - (UUID 45A8869B-BB90-495D-8A01-69B5FCC56086) Online
    Management cluster status: STABLE
    Number of nodes in control cluster: 3
    - (UUID 45A8869B-BB90-495D-8A01-69B5FCC56086)
    - (UUID 45A8869B-BB90-495D-8A01-69B5FCC56086)
    - (UUID 45A8869B-BB90-495D-8A01-69B5FCC56086)

What to do next

Initialize the control cluster. See Initialize the Control Cluster to Create a Control Cluster Master.