When NSX Upgrade is done via API, the upgrade-coordinator upgrade fails with error

Products

• VMware NSX

Issue/Introduction

• NSX is being upgraded via API
• After the MUB file is uploaded, an upgrade upgrade-coordinator API is initiated and it fails with error.
  2025-08-19T16:49:00.295Z ERROR Thread-9 UpgradeCoordinatorUpgradeService 371371 SYSTEM [nsx@6876 comp="nsx-manager" errorCode="MP30040" level="ERROR" subcomp="upgrade-coordinator"] Error while updating upgrade-coordinator due to error Error while extracting upgrade bundle VMware-NSX-upgrade-bundle-4.2.2.1.0.24765084.mub.
com.vmware.nsx.management.upgrade.exceptions.UcUpgradeFailedException: null
        at com.vmware.nsx.management.upgrade.bundle.UpgradeBundleUcHelperErrorHandler.handleExtractBundleErrors(UpgradeBundleUcHelperErrorHandler.java:84) ~[libuc-core.jar:?]

Environment

VMware NSX

Cause

Once the MUB file is uploaded the upgrade-coordinator will extract the file and verify integrity of it. If another upgrade related task(upgrade_uc as an example) is initiated before these default tasks are complete, they may fail.

Resolution

This is an user error.

Workaround:
Monitor the upgrade bundle status with the below API and initiate other upgrade related tasks or proceed further only the state changes to SUCCESS.

"GET /api/v1/upgrade/bundles/latest/status?operation=UPLOAD"
{
  "status" : "SUCCESS",
  "percentage" : 100,
  "operation" : "UPLOAD",
  "step" : "UPLOAD_COMPLETE",
  "progress_messages" : [ "Upgrade Bundle retrieved successfully" ],
  "upgradeBundleType" : "MUB"
}
https://developer.broadcom.com/xapis/nsx-t-data-center-rest-api/4.2.1/method_GetUpgradeBundleStatus.html

Additional Information

The default steps after the MUB upload is below.
Preparing Local File
Validating Bundle
Uploading Bundle
Extracting Bundle Signature --> Runs for a few minutes
Verifying Bundle Signature --> Runs for a few minutes
Checking Version Compatibility
Processing Bundle
Deleting Temporary Files
Upload Complete