VCF NSX Manager Upgrade Fails with error_code 30923, Cannot upgrade component MP

Products

• VMware Cloud Foundation

Issue/Introduction

During a VMware Cloud Foundation (VCF) Operations upgrade, the NSX Manager upgrade task fails.

The LCM debug logs (/var/log/vmware/vcf/lcm/lcm-debug.log) and the VCF Operations UI display the following error message:
Cannot upgrade component MP, since HOST component has upgrade units that have not been upgraded and are not in Transport Node maintenance mode., httpStatus : BAD_REQUEST, error_code : 30923

Additionally, checking the NSX Manager UI under System > Upgrade shows that the Upgrade Hosts step is incomplete or paused, despite NSX not being actively utilized on the ESXi host transport nodes.
Screenshot below shows this:

Environment

VMware Cloud Foundation 9.0.1.x
NSX 4.2.4.x

Cause

The NSX Upgrade Coordinator strictly enforces the component upgrade sequence: Edges -> Hosts -> Management Plane (MP).
The VCF Operations upgrade workflow attempts to trigger the MP upgrade via API; however, the NSX Upgrade Coordinator state is paused because the Host upgrade phase is empty but remains unacknowledged.
This incomplete state actively rejects the API request to proceed to the MP phase.

Resolution

 

• Log in directly to the NSX Manager user interface as an administrator.

• Navigate to System > Upgrade.

• Review the Upgrade Summary panel.

• Click Continue with Upgrade to manually acknowledge and bypass the empty Host upgrade phase.

• Verify that the Upgrade Hosts stage is now marked as successfully completed.

• Return to the VCF Operations user interface.

• Resume or retry the paused NSX Manager upgrade workflow.