VCF Domain Upgrade Fails with error: "Target VCF Version is lower than source VCF Version"
search cancel

VCF Domain Upgrade Fails with error: "Target VCF Version is lower than source VCF Version"

book

Article ID: 434258

calendar_today

Updated On:

Products

VCF Operations/Automation (formerly VMware Aria Suite) VMware Cloud Foundation

Issue/Introduction

  • When you attempt a VCF instance upgrade in Fleet Management from the Lifecycle Management > Updates tab in SDDC Manager, or the SDDC Manager UI you may observe that the bundle retrieval status in the Available Updates section spins indefinitely.

  • After few seconds you will observe at the top of the update page an error similar to the excerpt below:

    Retrieving update patches bundles failed. Unable to retrieve aggregated LCM bundles: Error in getDomainBomVersion(): Encountered error requesting http://127.0.0.1/v1/system/upgradables api: Target VCF Version 5.2.x.x is lower than source VCF Version 9.0.x.x.

    Getting Upgradable API call failed. Target VCF Version 5.2.x.x is lower than source VCF Version 9.0.x.x.

Environment

VMware Cloud Foundation 9.x

VMware Cloud Foundation 5.2.x

Cause

This issue occurs when a domain retains a stale target upgrade version that is lower than the current source version. The LCM service cannot resolve the upgrade path because the metadata indicates a version downgrade, which causes the bundle discovery process to hang or fail.

Resolution

You can resolve this issue by identifying the affected domain ID and clearing the stale upgrade metadata through the SDDC Manager API.

Identify the Stale Domain Entry

  1. Log in to VCF Operation and select Developer Center / API & SDKs .

  2. Select the SDDC Manager API Explorer.

  3. Locate the TargetUpgradeVersion section.

  4. Expand the GET /v1/releases/domains endpoint and click Execute.

  5. Review the DomainReleaseView in the API response.

  6. Verify if the targetSddcManagerVersion field is empty for each domain.

  7. Locate any domain entry where the version is lower than your current source version and record the domainId.

Remove the Stale Entry

  1. Stay within the TargetUpgradeVersion section of the API Explorer.

  2. Locate the DELETE /v1/releases/domains/{domainId} endpoint.

  3. Enter the domainId you retrieved in the previous step into the required field.

  4. Click Execute to remove the stale upgrade record.

  5. Verify the removal by running the GET request again to ensure the targetSddcManagerVersion is now clear.

Powered by Wolken Software