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

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

book

Article ID: 326356

calendar_today

Updated On:

Products

VMware NSX Networking

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"
  1. Power On the Edge VM
 
To verify the change took effect, at the root CLI of the Edge, execute:
root@nsx-civt-1072-124-198:~# 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