"LcmException - LCM crashed during bundle download" error banner on SDDC Manager

Products

• VMware Cloud Foundation

Issue/Introduction

When navigating to Bundle Management in the SDDC Manager UI, the following error message is displayed:

LcmException: LCM crashed during bundle download

The LCM service may remain in a 'Running' status, but users are unable to view or manage specific upgrade bundles, which can block the VMware Cloud Foundation (VCF) upgrade flow.

Environment

VMware Cloud Foundation (VCF) 5.x

Cause

This issue occurs when bundle entries in the SDDC database are in an inconsistent state (e.g., FAILED, PENDING, or DOWNLOAD_PENDING) due to interrupted downloads, network timeouts, or service restarts during a download task. These entries prevent the LCM service from successfully parsing the bundle graph.

Resolution

To resolve this issue, you must identify the problematic bundles in the database and remove them using the Bundle Cleanup Utility.

1. Identify Failed or Pending Bundles

SSH to the SDDC Manager appliance as the vcf user and switch to root. Run the following command to query the LCM database for all bundles that are not in a 'SUCCESS' state:

/usr/pgsql/13/bin/psql -h localhost -U postgres -d lcm -c "SELECT bundle_id, bundle_type, bundle_download_status FROM bundle WHERE bundle_download_status != 'SUCCESS';"

Alternatively, you can grep the LCM debug logs to find bundle IDs that caused recent parsing failures:

grep -i "Failed to add edge in bundle graph" /var/log/vmware/vcf/lcm/lcm-debug.log

2. Perform Bundle Cleanup

Before proceeding, ensure you have a fresh snapshot of the SDDC Manager VM.

For each bundle_id identified in Step 1, run the cleanup script:

python /opt/vmware/vcf/lcm/lcm-app/bin/bundle_cleanup.py <bundle_id>

To clean up multiple bundles simultaneously, you can pass multiple IDs separated by spaces.

python /opt/vmware/vcf/lcm/lcm-app/bin/bundle_cleanup.py "<ID_1>" "<ID_2>"

3. Restart LCM Service

Restart the service to refresh the database state and the UI:

systemctl restart lcm

Verify that the LcmException error has cleared from the SDDC Manager UI.