Error: "Software Solution com.vmware.vsphere-ha cannot be found in depot" when configuring vSphere HA
search cancel

Error: "Software Solution com.vmware.vsphere-ha cannot be found in depot" when configuring vSphere HA

book

Article ID: 438194

calendar_today

Updated On:

Products

VMware vCenter Server 8.0 VMware vSphere ESXi

Issue/Introduction

This article provides steps to resolve the error "A general system error occurred: Image is not valid. Software Solution com.vmware.vsphere-ha with version #### cannot be found in depot" encountered when enabling vSphere HA within a vSphere Lifecycle Manager (vLCM) managed cluster. This error occurs following vCenter Server upgrades (e.g., to VCSA 8.0 U3k) or during cluster remediation tasks, particularly in Enhanced Linked Mode (ELM) environments where metadata inconsistencies may occur in the vCenter Lifecycle Manager depot.

  • Enabling vSphere HA within a cluster fails with the following error:
    A general system error occurred: Image is not valid. Software Solution com.vmware.vsphere-ha with version ... cannot be found in depot.
  • /var/log/vmware/vmware-updatemgr/vum-server/vmware-vum-server.log reports below errors:
    YYYY-MM-DDTHH:MM:SS error vmware-vum-server[###] [Originator@6876 sub=com.vmware.vcIntegrity.lifecycle.SetSolutionTask] [SetSolutionTask 357] Software Solution com.vmware.vsphere-ha with version 8.0.3-25197330 cannot be found in depot.

    YYYY-MM-DDTHH:MM:SS error vmware-vum-server[###] [Originator@6876 sub=com.vmware.vcIntegrity.lifecycle.SetSolutionTask] [SetSolutionTask 365]  Set solution failed. entityId: domain-c### Problems found while validating the new software spec: {
    -->     "errors": [
    -->         {
    -->             "id": "com.vmware.vcIntegrity.lifecycle.EsxImage.SolutionNotFound",
    -->             "message": {
    -->                 "args": [
    -->                     "com.vmware.vsphere-ha",
    -->                     "8.0.3-25197330"
    -->                 ],
    -->                 "default_message": "Software Solution com.vmware.vsphere-ha with version 8.0.3-25197330 cannot be found in depot.",
    -->                 "id": "com.vmware.vcIntegrity.lifecycle.EsxImage.SolutionNotFound",
    -->                 "localized": null,
    -->                 "params": null
    -->             },
    -->             "originator": null,
    -->             "resolution": null,
    -->             "retriable": null,
    -->             "time": "",
    -->             "type": null
    -->         }
    -->     ],
    -->     "info": [],
    -->     "warnings": []
    --> }

Environment

VMware vCenter Server 8.x

Cause

This issue occurs when there is a partial or incomplete reference of the vSphere HA zip file within the Lifecycle Manager offline depot metadata, often resulting from corrupted or stale entries post-upgrade.

Resolution

To remediate the depot and enable HA, perform the following steps:

  1. Open the vSphere UI and navigate to Developer Center > API Explorer.
  2. In the Select Endpoint field, enter the vCenter's FQDN.
  3. In the Select API dropdown, choose ESX.
  4. Locate the GET /api/esx/settings/depots/offline call and click Execute.
  5. Scroll through the results to find the vsphere-ha VIB version referenced in the error message and note the datastore ID.

NOTE: While selecting the datastore ID, please copy only the ID.

  1. Locate the DELETE /api/esx/settings/depots/offline/{depot}  call.
  2. Input the datastore ID in the Value field and click Execute.
  3. Connect to the vCenter Server via SSH and restart the VMware Update Manager service: service-control --restart vmware-updatemgr 
  4. Monitor the vSphere UI Recent Tasks and wait for the Database Sync task to complete.
  5. Once the sync is finished, enable vSphere HA on the cluster.

Additional Information