VCF Offline Depot Download Tool Fails Due to Incorrect Depot Store Directory Path
Article ID: 446454
Updated On:
Products
Issue/Introduction
- The VCF offline depot download tool fails to properly download ESX updates.
- The issue occurs when executing the
vcf-download-toolcommand, resulting in an incorrectly built data pad structure within the offline depot. When attempting to download ESXi host patches from an offline depot in VMware Cloud Foundation (VCF) 9.1, the UMDS_SYNC task fails during the "Downloading Esx metadata, vibs and vendor add-ons" phase.
The following error is observed in the Operation Lifecycle Management interface:
Failed to execute UMDS command: /opt/vmware/vmware-umds/bin/vmware-umds -D -m --info-level error --task-id [TASK_ID]
Environment
VMware Cloud Foundation 9.1
VCF Offline Download Tool 9.1
Cause
The issue is caused by an incorrect directory structure or an invalid path specified in the --depot-store parameter when using the vcf-download-tool
The tool expects the --depot-store parameter to point to the root directory of the depot store. If a sub-directory (e.g., /umds-patch/store) is specified, the UMDS command fails to correctly map the underlying data structure required for metadata and VIB extraction.
Resolution
- Clean up the existing depot (Optional but recommended):Delete existing inconsistent data in the offline depot directory to ensure a clean sync.
- Execute the corrected download command: Ensure the --depot-store parameter points to the base root of your depot location.
Incorrect Example:
/opt/vcf-download-tool/bin/vcf-download-tool esx download --depot-store /var/lib/vcfdepot/umds-patch/store...Correct Example:
/opt/vcf-download-tool/bin/vcf-download-tool esx download --depot-download-activation-code-file [FILE] --depot-store /var/lib/vcfdepot/ --proxy-server=[PROXY] - Verify Sync: After the download tool completes successfully, re-initiate the UMDS sync from the VCF interface.
Additional Information
Feedback
