During an NSX-T upgrade, the pre-check reports - Error: "Repository sync is not complete on node [IP_ADDRESS]."

Products

• VMware NSX

Issue/Introduction

• When upgrading NSX, precheck fails with error for Repository Sync not completing:
  
  Following errors are reported: 
  
  
  • Repository sync is not complete on < Node IP>. Please wait for repository sync to complete, or resolve the errors if repository sync has failed.
    
    
    
    Or
    
    
  • Error: "Repository sync is not complete on node <  Node - IP >"
    
    

 

Environment

NSX-T 4.1.2

Cause

This error occurs when the Upgrade Coordinator (running on the orchestrator node) detects a checksum mismatch or missing files in the local repository of a cluster member. The repository contains the installation bundles required for the upgrade. If a node fails to download or verify these bundles, it cannot proceed with the upgrade, triggering the "Repository sync is not complete" message to prevent cluster inconsistency.

Resolution

• Identify the Manager node(s) with the REPO_SYNC status of "FAILED".
  
  
  • In the NSX Manager, navigate to System -> Appliances and then "View Details" for each manager appliance.
    
    

• • Click the "RESOLVE" option in order to sync the "/repository" directories between the Manager nodes.
    
    

• • Once the task completes, ensure the status now reports as "Success".
    
    
  • If identified as part of an NSX upgrade, reattempt the precheck to ensure the error is cleared.

Additional Information

The size of the "/repository" directory may not be consistent between the Manager nodes before the sync is completed successfully.