VMware NSX manager upgrade prechecks fail: Failed to execute Check for sufficient free space on /tmp, /image and /config partition

Products

• VMware NSX

Issue/Introduction

• During an NSX upgrade the prechecks fail for the managers with error:
  
  

  Failed to execute Check for sufficient free space on /tmp partition.
  Failed to execute Check for sufficient free space on /image partition.
  Failed to execute Check for sufficient free space on /config partition.

  
  As root on the NSX managers, running df -h, we see no space issues.
  
  /tmp has more than 18 MB free
  /image has more than 4299 MB free
  /config has more than 14796 MB free
  
  
• On the NSX Manager orchestrator node, in log /var/log/upgrade-coordinator/upgrade-coordinator.log, the following errors are seen:
  
  

  2025-08-14T20:16:14.552Z ERROR pool-50-thread-15 UcRestClient 4198 SYSTEM [nsx@6876 comp="nsx-manager" errorCode="MP30014" level="ERROR" subcomp="upgrade-coordinator"] Error during GET rest request /nsxapi/api/v1/cluster/nodes/#########-####-####-####-###########/status?source=realtime , trial 5 , err com.vmware.nsx.management.upgrade.rpcframework.UcRestRpcException: [UC] Error in rest call. url= //nsxapi/api/v1/cluster/nodes/#########-####-####-####-###########/status?source=realtime , method= GET , response= {
      "module_name" : "common-services",
      "error_message" : "General error has occurred.",
      "details" : "com.vmware.nsx.messaging.exceptions.InvalidArgumentException",
      "error_code" : 100
  }
   , error= 500 : "{<EOL>    "module_name" : "common-services",<EOL>    "error_message" : "General error has occurred.",<EOL>    "details" : "com.vmware.nsx.messaging.exceptions.InvalidArgumentException",<EOL>    "error_code" : 100<EOL>}<EOL>" .
  com.vmware.nsx.management.upgrade.rpcframework.UcRestRpcException: org.springframework.web.client.HttpServerErrorException$InternalServerError: 500 : "{<EOL>    "module_name" : "common-services",<EOL>    "error_message" : "General error has occurred.",<EOL>    "details" : "com.vmware.nsx.messaging.exceptions.InvalidArgumentException",<EOL>    "error_code" : 100<EOL>}<EOL>"

Note: To find the Orchestrator node, as admin user run: get service install-upgrade - the IP address in the 'running on' section of the result, shows which manager is the orchestrator node.

Environment

VMware NSX

Cause

The exception is happening because MPA entity-id entry for node #########-####-####-####-########### in ClusterNodeConfigModel is not set.

Resolution

This is a known issue impacting VMware NSX.

Workaround:

On the node we are seeing the error about not sufficient space, please run:

1. Run the below script to restore the file /etc/vmware/nsx-mpa/mpaconfig.json
/opt/vmware/nsx-mpa/mpaconfigrestore.sh
   
   
2. Restart CBM so re-registration of MPA is done.
   /etc/init.d/nsx-cluster-boot-manager restart

Additional Information

Note: KB 376982 with the same error, but a different cause and solution can be found here:
VMware NSX-T manager prechecks fail: Failed to execute Check for sufficient free space on /tmp, /image and /config partition