VMware NSX-T LogoVMware NSX-T Logo

In this article I will demonstrate how to resolve the issue “NSX Edge configuration has failed. 1G hugepage support required” while upgrading NSX-T from 3.1 to 3.2 or later.

Introduction

Last week I tried to upgrade NSX-T from version NSX-T 3.1.x to NSX 4.0.1 in one of my lab environments.
Upgrading NSX-T usually is very straight-forward in these lab environments, but not this time.

I started with uploading the NSX upgrade bundle (VMware-NSX-upgrade-bundle-4.0.1.1.0.20598726.mub) to the NSX Manager using the UI.

All lights were green on my pre-checks, but during the first phase of the upgrade (upgrading the NSX Edges) an error occured.

NSX-T Upgrade Failed
NSX-T Upgrade Failed
Error: NSX Edge configuration has failed. 1G hugepage support required
Error: NSX Edge configuration has failed. 1G hugepage support required

This particular lab environment was running on older HPE DL360p hardware with E5-2670 v2 CPU’s and because of those CPU’s the 1G hugepage support error occured.

Solution

To resolve this error, you must add custom Configuration Parameters to the NSX Edge VM’s to be able to complete the NSX upgrade.

Take the following steps to add custom Configuration Parameters and resolve your issue.

  1. Power Off the Edge VM.
  2. Navigate to the VM and choose Edit Settings.
  3. Navigate to the second tab: VM Options.
  4. Expand the Advanced section.
  5. Locate Configuration Parameters and choose Edit Configuration.
  6. Add configuration params and add the following line:
    In name column: featMask.vm.cpuid.pdpe1gb
    In value column: Val:1
featMask.vm.cpuid.pdpe1gb = Val:1
featMask.vm.cpuid.pdpe1gb = Val:1

Repeat the above steps for each Edge VM, move back to the NSX-T Manager and retry the upgrade.

After addding the configuration parameters, retry the upgrade
After addding the configuration parameters, retry the upgrade

After adding the custom Configuration Parameters, the upgrade process progresses succesfully, as shown in the following figures.

NSX-T - Upgrade in Progress 1
NSX-T - Upgrade in Progress 2

External References

Loading

By Marc Roeleveld

VCDX-DCV #299 | Cloud Architect | Owner at Roeleveld Cloud Services

Leave a Reply

Your email address will not be published. Required fields are marked *