Cluster image validation fails with SolutionNotFound error for VMware-HBR-Agent in vSphere Lifecycle Manager

Products

• VMware vCenter Server

Issue/Introduction

Cluster image validation fails due to a missing software solution dependency in the depot.

The following error appears in the vmware-vum-server logs:

{
    "id": "com.vmware.vcIntegrity.lifecycle.EsxImage.SolutionNotFound",
    "message": {
        "args": [
            "VMware-HBR-Agent",
            "8.0.2-0.0.22435776"
        ],
        "default_message": "Software Solution VMware-HBR-Agent with version 8.0.2-0.0.22435776 cannot be found in depot."
    }
}

Environment

VMware vCenter Server

Cause

A stale or orphaned reference to the VMware-HBR-Agent component exists within the cluster's image configuration. The vLCM depot does not contain the specific version referenced, leading to a validation failure when the system attempts to resolve dependencies.

Resolution

To resolve this issue without manual database modifications, you can export, edit, and re-import the cluster image manifest:

1. Export the Image: Navigate to the cluster image settings and export the current configuration as a JSON manifest.
2. Edit the Manifest: Open the exported JSON file in a text editor. Locate the entry for VMware-HBR-Agent (specifically version 8.0.2-0.0.22435776) and remove the stale line/object from the configuration.
3. Import the Manifest: Re-import the modified JSON file back into the vLCM cluster image settings.
4. Validate: Run the image validation again to ensure the error is resolved.

Additional Information

While internal KB 417691 suggests direct database (VCDB) edits, the steps above utilize supported vLCM workflows to achieve the same result safely.