Error: VCF Automation 9.0.2 install fails when binary download is stuck in IN_PROGRESS

Products

• VCF Operations

Issue/Introduction

Attempting to install VCF Automation 9.0.2 from Fleet Manager fails.

The Install binary download task remains stuck in IN_PROGRESS.

Logs at /var/log/vrlcm/vmsp_bootstrap_####.log show: Error: checksum mismatch, got: ####.

Clearing the failed state using KB Fleet Manager binary download Stuck in IN_PROGRESS State from VCF Operations and retrying the download does not change the status from IN_PROGRESS.

Environment

• VMware Cloud Foundation (VCF) 9.x
• VCF operations 9.x

Cause

The product binary downloaded to the local depot is corrupted or incomplete, leading to a SHA256 checksum mismatch during the deployment phase. A race condition in the Fleet Manager database prevents the status from being reset through the UI.

Resolution

To resolve the issue, follow the steps below:

Step 1: Download and Verify the Product Binary

Download the vRA 9.0.2.0 binary again.

Verify the integrity of the downloaded archive and inspect its contents by running the following commands:

• Check the SHA256 Hash:
  sha256sum vmsp-vcfa-combined-9.0.2.0.25145732.tar
  (Ensure the output matches the expected checksum from the Broadcom support portal)
• List Archive Contents:
  tar tvf vmsp-vcfa-combined-9.0.2.0.25145732.tar

Once you confirm the file is valid and complete, proceed to the Binary Management page to trigger the download.

Step 2: Check Status in Fleet Management UI

1. Log in to the Fleet Management UI.
2. Navigate to the Install Binary section and check the current status of the Automation 9.0.2.0 version.
3. Determine if the status is currently showing as IN_PROGRESS or NOT_DOWNLOADED.

Step 3: Clear Stale Stuck Downloads (If Status is IN_PROGRESS; If not, go to Step 5)

If the binary is stuck in an IN_PROGRESS state, execute the following API call to clear the download state:

Note: Replace the IP and authorization values in the below command. Follow KB How to Authorize VCF Operations Fleet Management API to get the authorization token. To get the data field values, follow Fleet Manager binary download Stuck in IN_PROGRESS State from VCF Operations.

curl --request POST \
--url https://<fleet_IP>/lcm/lcops/api/settings/productbinarydelete \
--header 'authorization: Basic <Auth_token>' \
--header 'content-type: application/json' \
--data '{ "productId": "vra", "productVersion": "9.0.2.0", "productBinaryType": "install", "productBinaryPath": "vcfa-bundle-9.0.2.0.25145732.tar", "componentName": "vraInstall", "mappingType": "Broadcom Depot", "productName": "automation", "requestId": null, "removeBinary": null, "depotType": null, "downloadStatus": "IN_PROGRESS", "patchId": null, "size": null, "releaseDate": null }'

Step 4: Retry the Binary Download

1. Return to the Binary Management page.
2. Locate Automation 9.0.2.0 under the Install Binaries section.
3. Click Download to restart the process cleanly.

Additional Information

Important Note (If the Binary Management page appears empty):

If the Binary Management UI lists no available binaries, perform the following metadata recovery steps:

• Copy the metadata mapping catalog files to their respective target paths: Copy vcfManifest.json to the /data/PROD/metadata/manifest/v1/ directory.
• Copy productVersionCatalog.json to the /data/PROD/metadata/productVersionCatalog/v1/ directory.
• Navigate to the Depot Configuration page in the UI.
• Click Edit Settings, leave the parameters as they are, and click OK to re-sync the metadata.[cite: 1]