Before you upgrade NSX-T Data Center, perform the pre-upgrade tasks to ensure that the upgrade is successful.

Procedure

  1. If you are upgrading from a version earlier than NSX-T Data Center 3.0, provision a secondary disk of exactly 100 GB capacity on all NSX Manager appliances.
    • For an ESXi host, login to vCenter Server, navigate to the NSX Manager VM and add a disk of exactly 100GB capacity.
    • For a KVM host:
      1. Create a disk of 100 GB capacity:
        qemu-img create -f qcow2 nsx-unified-appliance-secondary.qcow2 100G
      2. Create an xml file ( /<download folder>/<nsx_manger_vm_name_storage_file.xml>) for the additional storage:
        <disk type='file' device='disk'>
         <driver name='qemu' type='qcow2' cache='none'/>
         <source file='/<diskPath>/nsx-unified-appliance-secondary.qcow2'/>
         <target dev='vdb' bus='virtio' />
        </disk>
      3. Make the VM persistent using the following commands:
        virsh dumpxml <NSX Manager VM> > /<download folder>/<nsx_manager_vm_name.xml>
        virsh define /<download folder>/<nsx_manager_vm_name.xml>
        virsh list –all
      4. Attach the secondary disk to the NSX Manager appliance:
        virsh attach-device --config  <NSX Manager VM> /<download folder>/<nsx_manger_vm_name_storage_file.xml>
      5. Shutdown and start the NSX Manager appliance:
        virsh shutdown <NSX Manager VM>
        virsh start <NSX Manager VM>
        
      6. Repeat the process for the other NSX Manager appliances in the cluster.
      Note: Reboot the appliance if the secondary disk is not detected by the Upgrade Coordinator. Run the pre-check to ensure that the secondary disk is detected and proceed with other NSX Manager appliances.
  2. Ensure that you backup the NSX Manager before you start the upgrade process. See the NSX-T Data Center Administration Guide.
  3. Ensure that your host OS is supported for NSX Manager. See Supported Hosts for NSX Managers in the NSX-T Data Center Administration Guide
  4. Disable automatic backups before you start the upgrade process. See the NSX-T Data Center Administration Guide for more information on configuring backups.
  5. Ensure that the appropriate communication ports are open from the Transport and Edge nodes to the NSX Managers:
    • TCP ports 1234 to NSX Manager
    • TCP port 1235 to NSX Controller
    • Keep port 5671 open during the upgrade process.
    NSX Cloud Note: Starting with NSX-T Data Center 2.5.1, NSX Cloud supports communication on port 80 between the Cloud Service Manager appliance installed on-prem with the NSX Public Cloud Gateway installed in your public cloud VPC/VNet. NSX-T Data Center versions 2.5.0 and earlier require port 7442 for this communication. During the upgrade from versions 2.5.0 and earlier to 2.5.1, keep port 7442 open. See Enable Access to Ports and Protocols in the NSX-T Data Center Installation Guide for more information.
  6. Before you place your ESXi host in maintenance mode, power off any NSX Edge VMs that may be residing on the host and ensure that the NSX Edge VMs continue to reside on the same host.
  7. For NSX-T Data Center 3.0, you need a valid license to use licensed features like T0, T1, Segments, and NSX intelligence. Ensure that you have a valid license.
  8. Ensure that you perform an automated pre-check to verify that the NSX-T Data Center components are ready for upgrade. The pre-check process scans for component activity, version compatibility, component status of the hosts, NSX Edge, and management plane. Resolve any warning notifications to avoid problems during the upgrade.
  9. Delete all expired user accounts before you begin upgrade. Upgrade for NSX-T Data Center on vSphere fails if your exception list for vSphere lockdown mode includes expired user accounts. For more information on accounts with access privileges in lockdown mode, see Specifying Accounts with Access Privileges in Lockdown Mode in the vSphere Security Guide.