VCF Installer UI reports a BUNDLE_CHECKSUM_ERROR while downloading component binaries from an offline depot

Products

• VMware SDDC Manager / VCF Installer
• VMware Cloud Foundation

Issue/Introduction

• When attempting to download component binaries (e.g., telemetry-acceptor) from an offline depot served by Apache, the VCF Installer UI reports a BUNDLE_CHECKSUM_ERROR.

  LcmException: Patch file /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles/####-####-####-####/####-####-####-####/telemetry-acceptor-9.1.0.0.25181946.tgz checksum e1f7c0902c25802c1066e05793dbe7515a0440cce8572f8ab618fe2e476745b4 does NOT match with the element checksum a96dccc92fce137bfdcb1df317d7e8c8f9056194a0dc48921ff97812fdb909d4

• /var/log/vmware/vcf/lcm/vcf_lcm.log on SDDC Manager:

  LcmException: Patch file /nfs/vmware/vcf/nfs-mount/bundle/depot/local/bundles/####/telemetry-acceptor-/####.tgz checksum /####... does NOT match with the element checksum /####...

• Performing a curl test on the file reveals the following "Content-Encoding":

curl -sSkI https://<depot_fqdn>/PROD/COMP/TELEMETRY_ACCEPTOR/telemetry-acceptor-9.1.#####.tgz
HTTP/1.1 200 OK
Date: ###, DD MM YYYY SS:MM:HH GMT
Server: Apache
Last-Modified: DD MM YYYY SS:MM:HH GMT
ETag: "#####"
Accept-Ranges: bytes
Content-Length: #####
Content-Encoding: x-gzip 

Environment

• VMware Cloud Foundation (VCF) 9.x

Cause

The Apache web server is configured to append the Content-Encoding: x-gzip header to .tgz or .gz files. When the VCF Installer receives this header, it decompresses the file during transfer. The installer then calculates the checksum of the resulting .tar file instead of the original compressed .tgz file, leading to a mismatch against the manifest.

Resolution

Configure the Apache server to transmit .tgz and .gz files without applying compression headers.