I haven't been writing much about NSX so far, but I am working on an Internet of Things (IoT) Project where NSX is one of the core products. In Today post Step by Step NSX Upgrade, I would like to show you how NSX upgrade should be done.
Before we upgrade
It is very important to validate all necessary components before NSX is upgraded. It is not only valid for a minor upgrade which we will be doing - 6.2.2 to 6.2.3, but for every version. Checklist below will help you to prepare your environment to upgrade:
- Download NSX upgrade bundle and check MD5.
- There is known bug which affects EDGE upgrade when incorrect ciphers are configured. VMware KB NSX Edge is unmanageable after upgrading to NSX 6.2.3 explain steps needed to check it and/or change it before the upgrade.
- Familiarize yourself with Update sequence for vSphere 6.0 and its compatible VMware products.
- Backup of components:
- Take a backup of NSX Manager (if you are not doing it regularly) before the upgrade.
- Before upgrading download technical support logs.
- Export of vSphere Distributed Switches configuration. Check out my Git repository for the detailed script.
- Create a backup of vCenter Server database.
- Take a snapshot of vCenter Server and vCenter Server database.
- Take a snapshot of NSX Manager (without quiescing VMware Tools, because it is not supported and it might crash your NSX Manager).
3, 2, 1 - Go!
Upgrade of NSX Manager
- Download NSX upgrade bundle.
- Login to NSX Manager and go to Upgrade section.
- Click on Upgrade button, specify a location of upgrade bundle and click Continue.
- It will take few minutes to upload it.
- Choose if you want to enable SSH and participate in Customer Experience Improvement Program (CEIP). Click Upgrade to proceed.
- Upgrade takes a while so be patient. In my lab, it took 15 minutes.
- GUI reports that upgrade was done.
- Go back to vSphere Web Client and go to Networking&Security. After logging in I immediately noticed new section Dashboard.
NSX Controllers Upgrade
- To continue upgrade click on Installation and hit Upgrade Available button.
- Confirm that we want to proceed with Controllers upgrade.
- It will take few moments to upgrade controllers. In my case, it was ~15 minutes per controller.
- Once all controllers upgraded and the reboot is finished, green status is displayed.
VMware ESXi NSX VIBs Upgrade
- Navigate to Installation section and click Host Preparation.
- Click on Upgrade Available in every cluster you are using NSX and confirm Upgrade by clicking Yes.
- In vSphere Client uninstalls and install tasks are visible.
- To finish with upgrade ESXi hosts have to be rebooted.
NSX Edge Services Gateway and Distributed Logical Router Upgrade
- Next step is to upgrade Edge Services Gateway and Distributed Logical Router. In my environment, I have only ESG deployed so we will proceed with the upgrade of it.
- Please remember that there might be service interruption depending on a configuration used in environment.
- In vSphere Web Client in current tasks, it is visible, that two temporary new Edge Services Gateways deployment is in progress.
- After two minutes Edge Services Gateways upgrade to 6.2.3 is completed.
- Same procedure should be used to perform an upgrade of Distributed Logical Routers.
- Check if NSX Manager is working.
- Check if NSX Manager backup is working.
- Check if NSX VIBs are installed on ESXi host.
- Resynchronize the host message bus.
- Remove snapshot from NSX Manager.
- Remove snapshot from vCenter Server.
- Remove snapshot from vCenter Server database.