SDDC Upgrade Prechecks fail with dataplane check. Failed to execute ESXi maintenance-mode upgrade dataplane check. Error occurred while copying the upgrade scripts to host. SFHC connectivity may be down.

Products

• VMware NSX
• VMware SDDC Manager

Issue/Introduction

• From SDDC, NSX prechecks fail with the error:

ESXi maintenance-mode upgrade dataplane check: [Failed to execute ESXi maintenance-mode upgrade dataplane check. Failed to execute ESXi maintenance-mode upgrade dataplane check. Error occurred while copying the upgrade scripts to host. SFHC connectivity may be down.]:

• On NSX, you may see the following:

2025-04-14T09:44:38.442Z  INFO pool-60-thread-1 UpgradeServiceImpl 2946 SYSTEM [nsx@6876 comp="nsx-manager" level="INFO" subcomp="upgrade-coordinator"] Component type = HOST , Upgrade Status = FAILED, Progress Percentage = 99 , Progress Message = Pre-upgrade checks failed for HOST: Failed to execute ESXi maintenance-mode upgrade dataplane check. Error occurred while copying the upgrade scripts to host ######-####-####-####-#######. SFHC connectivity may be down.
...
2025-04-14T09:42:34.551Z  INFO task-executor-0-workitem-HOST-######-####-####-####-####### WorkItem 2946 SYSTEM [nsx@6876 comp="nsx-manager" level="INFO" subcomp="upgrade-coordinator"] [PUC] Executing check ESXi maintenance-mode upgrade dataplane check for upgrade-unit id ######-####-####-####-####### with name ESXi-FQDN
2025-04-14T09:42:34.551Z ERROR task-executor-0-workitem-HOST-######-####-####-####-####### SfhcScriptExecutionStrategy 2946 SYSTEM [nsx@6876 comp="nsx-manager" errorCode="MP30143" level="ERROR" subcomp="upgrade-coordinator"] Failed to read file /repository/3.2.3.1.0.22104592/HostComponents/esx65/nsx-esx-precheck
java.io.FileNotFoundException: File0Components/esx65/nsx-esx-precheck' does not exist

Cause

This is due to the upgrade orchestrator running an NSX-T manager that does not contain the required precheck files.

Resolution

Log onto each NSX-T node UI and select System > Upgrade
Note: This should inform you which node the orchestrator is currently running on

 

 

Review the upgrade-coordinator.log on the node the orchestrator is running on to find the file it is failing on.

 

1. Run the command: cat  /var/log/upgrade-coordinator/upgrade-coordinator.log | less
   similar error:
   ERROR pool-13-thread-12 SfhcScriptExecutionStrategy - SYSTEM [nsx@6876 comp="nsx-manager" errorCode="MP30143" level="ERROR" subcomp="upgrade-coordinator"] Failed to read file /repository/3.0.2.0.0.16887200/HostComponents/esx65/nsx-esx-precheck
   *The version directory is dependent on what version the customer is running
   
   
2. Go to the directory listed on each of the nodes to determine which NSX-T manager node the orchestrator should be running on
   cd /repository/3.0.2.0.0.1687200/HostComponents/esx65
ls -l ----->check for the precheck files
3. On the node that contains the precheck files, run the following command
   set repository-ip
   
   
4. Check the NSX UI and make sure the repo sync service has run successfully on all three managers, then re-run the precheck from the SDDC