How to successfully upgrade NSX-T from 3.1.0 to 3.1.1 1

How to successfully upgrade NSX-T from 3.1.0 to 3.1.1

VMware did a great job with simplifying the upgrade proces of all the NSX-T components. Today I will demonstrate how to perform an upgrade of a NSX-T environment from NSX-T 3.1.0 to NSX-T 3.1.1.

VMware docs: Upgrading NSX-T Data Center

Upgrade NSX-T Data Center


  • Check the VMware product interoperability matrices: link
  • Download the NSX-T upgrade .mub files: link

VMware Product Interoperability Matrix

In my lab, I have the following VMware products in place, that are integrated with each other:

  • NSX-T Data Center version: 3.1.0
  • vCenter version: 7.0 U1
  • VMware ESXI version: 7.0 U1
  • VMware Cloud Director version: 10.2

I need to verify the VMware product interoperability between the NSX-T Data Center version 3.1.1 and all the other products mentioned earlier.

VMware interoperability matrix
I have selected 3.1.1 version of NSX-T Data Center, and all other solutions will have the current version selected.
VMware interoperability matrix NSXT
The interoperability between these products with the new version of NSX-T is compatible.

There is only one warning about some features in VMware Cloud Director. We are good to go to start with the upgrade.

VMware interoperability matrix Cloud Director

Find the Orchestrator node (only required in a clustered NSX-T manager setup)

  1. Open a SSH session to a NSX-T manager and check the install-upgrade service. (in my lab, I only have a single NSX-T manager node.)
get service install-upgrade  
Orchestrator node NSX-T
The orchestrator node is enabled on node

2. Open a web browser and browse to the NSX-T manager web GUI. Do not use the VIP address but instead the NSX-T manager node IP address that has the install-upgrade enabled. Also, use local credentials to login on the web GUI. Example: https://nsx-manager-ip-address/login.jsp?local=true

Upload the upgrade .mub file

3. Once logged in to the web GUI of NSX-T, go to System –> Upgrade –> Upgrade NSX.

NSX-T upgrade orchestrator

4. Click on Browse, select the NSX-T Data Center 3.1.1 upgrade .mub file and click on Upload to start the upload of the .mub file.

NSX-T upload .mub file

The upgrade process has been started.

Uploading mub file

The compatibility matrix of the upgrade bundle will also be verified afterwards.

Checking compatibility NSX-T

6. We are now ready to perform the upgrade. Click on the Upgrade button to start the upgrade process.

NSX-T mub file

7. Accept the EULA and click on Continue.


8. Click on Yes, Continue to proceed.

NSX-T continue

The upgrade bundle will be extracted.

NSX-T Extract

After extracting the upgrade bundle, the Upgrade Coordinator will be restarted.

NSX-T  upgrade coordinator

Run Pre-Check

9. Click on Run Pre-Check –> all Pre-checks to start the precheck of the Edges, Hosts and NSX Manager.

NSX-T  precheck

10. Click on Run Pre Checks to continue.

NSX-T upgrade precheck

The Edges and Hosts passed the Pre Check. The NSX Manager has a warning about not having taking a backup in 2 days. This is just my home lab, so I don’t care about backups.

11. Click on Next to proceed

NSX-T upgrade

Upgrade Edge clusters

We are now ready to start with the upgrade of the Edge clusters.
There are two options as for upgrading orders of the Edge clusters:

Serial: Edge Clusters are upgraded in a sequence. The next edge cluster is picked up only after all the edgesin the current cluster are upgraded.

Parallel: Multiple edge clusters are upgraded simultaneously. However, edges within the cluster are upgrade serially.

I will leave this setting as default, because I only have 1 Edge cluster in my lab.

12. Click on Start to begin the upgrade of the Edges.

NSX-T Edge cluster

We now have wait until the Edges are upgraded successfully.

NSX-T upgrade edges

You can click on the Edge cluster to see the individual Edge nodes and their state. As you can see, the first Edge node was upgraded successfully.

NSX-T Upgrade edge

Both Edge nodes are upgraded successfully.
13. Click on Next to proceed.

NSX-T  edge

Upgrade ESXI hosts

We are now ready to start with the upgrade of the ESXI hosts
There are two options as for upgrading orders of the ESXI hosts:

Serial: All hosts in a group or cluster are upgraded before moving to the next group or cluster.

Parallel: Multiple groups or cluster of hosts are upgraded in parallel. Hosts within the cluster or group are also upgraded in parallel.

14. Click on Start to begin the upgrade of the ESXI hosts.


Wait until all ESXI hosts from all the clusters are upgraded successfully.

NSX-T  ESXI clusters

You can click on an ESXI cluster to see the individual ESXI hosts and their state. As you can see, the first ESXI host was upgraded successfully.

NSX-T Cluster ESXI

Both ESXI clusters are upgraded successfully.
15. Click on Next to proceed.


Upgrade the NSX Managers

The last components to upgrade are the NSX Managers. In my lab, I only have 1 NSX manager. So let’s proceed with upgrading the NSX manager.

16. Click on Start to upgrade the NSX Managers

NSX-T  manager

Note: Creating, updating, or deleting any managed object during an upgrade may lead to errors.

17. Click on Start to proceed.

NSX-T start

We now have to wait until the NSX Managers are upgraded.

NSX-T manager

At some point, the NSX-T manager will restart. Please be patient and reload the browser after a few minutes.

NSX-T  upgrade

The upgrade of the NSX-T manager has been completed.
18. Click on Next –> Next –> Next –> Done to finish.

NSX-T  finish upgrade

Leave a Comment