ESXi Host update scan task fails with error "The required package files are missing from the patch store on disk. Please reupload the upgrade package and reattempt the upgrade operation."

Products

• VMware vCenter Server

Issue/Introduction

• Scan task for the ESXi host update via Lifecycle Manager(LCM) within the vCenter fails with the error:
  The required package files are missing from the patch store on disk. Please reupload the upgrade package and reattempt the upgrade operation.

  
  
• Following entries are found in the vCenter logs:
  /var/log/vmware/vmware-updatemgr/vum-server/vmware-vum-server.log
YYYY-MM-DDTHH:MM:SS verbose vmware-vum-server[12313] [Originator@6876 sub=VciScanTask.ScanTask{1}] [vciTaskBase 892] New progress 5 for ScanTask{1}
YYYY-MM-DDTHH:MM:SS error vmware-vum-server[12313] [Originator@6876 sub=HUProductMgr] [productMgrImpl 397] Error accessing stagepath /storage/updatemgr/patch-store/host_upgrade_packages/esxi-upgrade-rukveyyojw type  1 error 2/No such file or directory
YYYY-MM-DDTHH:MM:SS error vmware-vum-server[12313] [Originator@6876 sub=HUPlanner] [plannerImpl 489] Required upgrade files are missing from the patch store on disk
YYYY-MM-DDTHH:MM:SS error vmware-vum-server[12313] [Originator@6876 sub=SingleHostUpgradeScanTask.SingleHostUpgradeScanTask{10}] [singleHostUpgradeScanTask 278] Caught HostUpgradePackageMissingFiles fault: Fault cause: integrity.fault.HostUpgradePackageMissingFiles
  
  

Environment

vCenter Server 8.x

Cause

This issue occurs because required ESXi update package files are missing from the LCM patch-store directory on the vCenter Server appliance, creating a mismatch with the VUM database. Consequently, scan tasks fail when the service attempts to access these files at their configured paths.

Resolution

To fix the inconsistency between the database and filesystem, reset the VUM database. This clears orphaned entries and forces a fresh download of update packages.

Perform the following steps:

1. Document Existing URLs: Make a note of all currently configured download token URLs.

2. Reset the VUM Database: Perform a VUM database reset to clear patch-store. (Reference: Resetting the VMware Update Manager Database)

   • Additional considerations apply when performing a VUM database reset in environments where NSX-T is configured. Refer: NSX-T environment VUM DB reset

3. Restore Configuration: Re-add the download token URLs documented in Step 1.

4. Re-run the Scan Task: Initiate the host update scan task again. LCM will successfully stage the missing files into the directory and proceed with the scan.