NSX – Troubleshoot NSX Controller cluster status, roles and connectivity

First up… overall status of the controller cluster:

1. Log into the Web Client.

2. Click Networking and Security.

3. Click Installation, then Management. From this screen make sure the controllers are healthy and connected (not red boxes under peers etc.):

You can also check the status on a controller cluster from ssh or the console by running show control-cluster status (I’ll also stick a screen grab of all the sub commands for show control-cluster):

Next up is Controller Roles, in any cluster something has to be the boss, be the primary or master etc. To check the role assign to an NSX Controller you need to SSH into the controller and run some commands.
Run the command “show control-cluster roles” (the controller with YES under the row MASTER is the master for that one role):

For completeness here is a screen grab of the second controller with “No” against the roles:

Last thing to check is Connectivity… again on the console of the controllers run the following: show control-cluster connections:


  1. Hi, I have one controller deployed. Command “show control-cluster roles” via deployed controller’s cli is showing Count of 2 for api_provider, switch_manager, logical_manager, directory_server and Count 1 for persistence_server. Why? Does it include NSX Manager?

    1. Hey Frantisek, how many controllers have you deployed?

      When I am checking the cluster health I always look for the majority leader (the one listening on port 2878, you can see “Y” in the “listening” column next to “server”). The other Controller nodes will have a dash in the “listening” column for Port 2878 and a “Y” next to client.

      The Open Connections column shows whether the majority leader has any open connections. In a 3-node controller cluster, the majority leader should show 2 open connections. It should be the same as the number of client controller nodes in the Cluster.

Leave a Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.