NSX-T Edge Node Upgrade from 3.1.3 to 3.2 fails with "NSX Edge configuration has failed. 1G hugepage support required"

Products

• VMware NSX
• VMware NSX-T Data Center

Issue/Introduction

NSX-T Edge Node Upgrade from 3.1.3 to 3.2 fails with "NSX Edge configuration has failed. 1G hugepage support required"

edge03> get upgrade progress-status
****************************************************************************
Node Upgrade has been started. Please do not make any changes, until
the upgrade operation is complete. Run "get upgrade progress-status"
to show the progress of last upgrade step.
****************************************************************************
Upgrade info:
From-version: 3.1.3.3.0.18844966
To-version: 3.2.0.0.0.19067089
 
Upgrade steps:
11-preinstall-enter_maintenance_mode [2021-12-27 16:47:58 - 2021-12-27 16:49:04] SUCCESS
download_os [2021-12-27 16:49:52 - 2021-12-27 16:51:31] SUCCESS
install_os [2021-12-27 16:51:33 - 2021-12-27 16:55:54] SUCCESS
switch_os [2021-12-27 16:55:57 - 2021-12-27 16:56:00] FAILED

 

Edge syslog:
[time-stamp] nsxedge datapath-systemd-helper 24617 - -  ERROR: NSX Edge configuration has failed. 1G hugepage support required

Environment

VMware NSX-T Data Center
VMware NSX

Resolution

This is a known issue impacting NSX-T Data Center 3.2.0 and 3.2.0.1 and resolved in VMware NSX-T 3.2.1 

Workaround:
A configuration change must be made to the Edge VM to allow it use 1GB hugepages.

1. Power off the Edge VM
2. On the vSphere Client select Edit Settings
3. Select the VM options tab
4. Expand Advanced and select Edit Configuration
5. Click Add Configuration Params
6. Add featMask.vm.cpuid.PDPE1GB = Val:1 
   
7.  Save the settings
8. Power on the Edge VM

To verify the change took effect, at the root CLI of the Edge, execute:

root@hostname:~# cat /proc/cpuinfo | egrep -o pdpe1gb | head -n 1
pdpe1gb

Note: In the case of an upgrade failure, retry the upgrade once the configuration change is complete.
Alternatively, the Edge VM can instead be moved to an ESXi host with a newer generation CPU which by default allows 1GB hugepages

Additional Information

https://techdocs.broadcom.com/us/en/vmware-cis/nsx/nsxt-dc/3-1/installation-guide/preparing-for-installation/system-requirements/nsx-edge-vm-system-requirements.html