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

Issue/Introduction

Symptoms:
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.
****************************************************************************
 
Mon Dec 27 2021 UTC 17:53:45.810
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


2021-03-11T12:55:47.304772+00:00 nsxedge datapath-systemd-helper 24617 - -  ERROR: NSX Edge configuration has failed. 1G hugepage support required

Resolution

Enable 1G hugepage support in the Edge VM.

1. Power Off the Edge VM
2. Add the following line to the Edge .vmx file:

featMask.vm.cpuid.PDPE1GB = "Val:1"

3. 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

Additional Information

https://docs.vmware.com/en/VMware-NSX-T-Data-Center/3.1/installation/GUID-22F87CA8-01A9-4F2E-B7DB-9350CA60EA4E.html#nsx-edge-vm-cpu-requirements-1

Impact/Risks:
NSX-T Edge Node fails to upgrade