The NSX upgrade is failing during the precheck phase on the ESXi host due to a java.lang.NullPointerException

Products

• VMware NSX

Issue/Introduction

• NSX upgrade precheck is failing on the ESXi host due to the error shown below
  • Login to the NSX manager as user admin.
  • Switch to the root shell by running the command st en
  • Navigate to the log file location /var/log/upgrade-coordinator/upgrade-coordinator.log

ERROR pool-49-thread-9 InspectionTask 71266 - [nsx@6876 comp="nsx-manager" errorCode="MP30956" level="ERROR" subcomp="upgrade-coordinator"] Execution of ESXi in-place upgrade dataplane check failed
java.lang.NullPointerException: null
        at com.vmware.nsx.management.upgrade.plugin.common.task.CustomInspectionTask.doSplitExecute(CustomInspectionTask.java:145) ~[libnsx-upgrade-plugins.jar:?]
        at com.vmware.nsx.management.upgrade.plugin.common.task.CustomInspectionTask.execute(CustomInspectionTask.java:77) ~[libnsx-upgrade-plugins.jar:?]
        at com.vmware.nsx.management.upgrade.inspection.UpgradeUnitInspectionTask.execute(UpgradeUnitInspectionTask.java:20) ~[libuc-core.jar:?]
        at com.vmware.nsx.management.upgrade.inspection.AbstractInspectionTask.executeWithMultipleResult(AbstractInspectionTask.java:66) ~[libuc-core.jar:?]
        at com.vmware.nsx.management.upgrade.service.impl.UpgradeServiceImpl.executeInspectionTask(UpgradeServiceImpl.java:1636) ~[libuc-core.jar:?]
        at com.vmware.nsx.management.upgrade.service.impl.UpgradeServiceImpl.executeUpgradeUnitPreUpgradeChecks(UpgradeServiceImpl.java:1616) ~[libuc-core.jar:?]
        at com.vmware.nsx.management.upgrade.service.impl.UpgradeServiceImpl.lambda$doExecuteUniversalPreUpgradeChecks$23(UpgradeServiceImpl.java:1326) ~[libuc-core.jar:?]
        at java.util.concurrent.Executors$RunnableAdapter.call(Unknown Source) ~[?:?]
        at java.util.concurrent.FutureTask.run(Unknown Source) ~[?:?]
        at java.util.concurrent.ThreadPoolExecutor.runWorker(Unknown Source) ~[?:?]
        at java.util.concurrent.ThreadPoolExecutor$Worker.run(Unknown Source) ~[?:?]
        at java.lang.Thread.run(Unknown Source) ~[?:?]

Environment

NSX 4.2.x

Cause

NSX upgrade precheck process is unable to fetch the information about PUB file (Pre-Upgrade Bundle)

Resolution

Verify manually if a newer version of the Pre-Upgrade Bundle (PUB) is available and upload the correct NSX PUB file based on the version being upgraded

It is recommended to run pre-checks with the latest Pre-Upgrade bundle before starting the upgrade to avoid any potential issues

 

Additional Information

Validate the NSX upgrade path NSX Upgrade Path

Should the issue persist, kindly open a support case with Broadcom. Creating and managing Broadcom support cases