VCF Operations - Unable to update the Supervisor Cluster with "Error processing Content Library" and "Error: malformed Supervisor OVF template name"
search cancel

VCF Operations - Unable to update the Supervisor Cluster with "Error processing Content Library" and "Error: malformed Supervisor OVF template name"

book

Article ID: 433761

calendar_today

Updated On:

Products

VMware vSphere Kubernetes Service

Issue/Introduction

Observing error like below and unable to update the Supervisor Cluster.

Error processing Content Library ########-####-####-####-############, Error: malformed Supervisor OVF template name ob-22035671-tkgs-ova-ubuntu-2004-v1.24.11---vmware.1-fips.1-tkg.1.ubuntu.


Checking the WCP logs shows Content Library logs which hint that maybe the incorrect content library is being used for the Supervisor.

As per logs below it appears to advise this is set to https://wp-content.vmware.com/v2/latest/lib.json currently.

2026-03-10T08:28:39.978Z debug wcp [content/controller.go:218] [opID=cl-########-####-####-####-############] Reconciling Content Library: ########-####-####-####-############, current state vector: &{state:APPLY status:ERROR phase:ERROR}
2026-03-10T08:28:39.978Z debug wcp [rest/client.go:86] [opID=cl-########-####-####-####-############] Rest client for vmodl2 API calls exists, checking session validity
2026-03-10T08:28:39.980Z debug wcp [rest/client.go:89] [opID=cl-########-####-####-####-############] Rest client for vmodl2 API calls is still valid.
2026-03-10T08:28:39.989Z debug wcp [content/cl.go:106] [opID=cl-########-####-####-####-############] Subscription URL for Supervisor Content Library: ########-####-####-####-############ is https://wp-content.vmware.com/v2/latest/lib.json
2026-03-10T08:28:39.989Z debug wcp [content/controller.go:359] [opID=cl-########-####-####-####-############] Processing Spherelet items for Library: ########-####-####-####-############

 

Also noted below OVC processing issues as a result which was also observed in original provided errors.

2026-03-10T08:28:40.031Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.036Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-22035671-tkgs-ova-ubuntu-2004-v1.24.11---vmware.1-fips.1-tkg.1.ubuntu of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA
2026-03-10T08:28:40.036Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.040Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-18186591-photon-3-k8s-v1.20.7---vmware.1-tkg.1.7fb9067 of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA
2026-03-10T08:28:40.040Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.043Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-22187091-ubuntu-2004-amd64-vmi-k8s-v1.26.5---vmware.2-fips.1-tkg.1 of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA
2026-03-10T08:28:40.044Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.048Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-24752897-ubuntu-2204-amd64-v1.31.7---vmware.1-fips-vkr.2 of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA
2026-03-10T08:28:40.048Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.052Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-25164274-photon-5-amd64-v1.34.2---vmware.2-vkr.2 of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA
2026-03-10T08:28:40.052Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.057Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-22748270-tkgs-ova-photon-3-v1.26.10---vmware.1-fips.1-tkg.1 of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA
2026-03-10T08:28:40.057Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.063Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-23049612-tkgs-ova-photon-3-v1.27.6---vmware.1-fips.1-tkg.1 of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA
2026-03-10T08:28:40.063Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.068Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-24076161-ubuntu-2204-amd64-vmi-k8s-v1.30.1---vmware.1-fips-tkg.5 of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA
2026-03-10T08:28:40.068Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.072Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-24942110-ubuntu-2204-amd64-v1.31.11---vmware.3-fips-vkr.1 of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA
2026-03-10T08:28:40.072Z debug wcp [content/controller.go:383] [opID=cl-########-####-####-####-############] Processing Spherelet Library item ########-####-####-####-############
2026-03-10T08:28:40.077Z info wcp [content/controller.go:392] [opID=cl-########-####-####-####-############] Skipping item: ob-22757567-tkgs-ova-photon-3-v1.25.13---vmware.1-fips.1-tkg.1 of library: ########-####-####-####-############ from Spherelet processing as it is of type OVA

 

Environment

VCF 9.x

Cause

Incorrect Subscription URL confirued in Supervisor Management -> Content Distribution -> Supervisor Images Library:

2026-03-10T08:28:39.989Z debug wcp [content/cl.go:106] [opID=cl-########-####-####-####-############] Subscription URL for Supervisor Content Library: ########-####-####-####-############ is https://wp-content.vmware.com/v2/latest/lib.json

Resolution

Do not attempt to delete or edit the content library that is assigned with the Supervisor release images. You must unassign the Supervisor release images before you attemp to delete or edit the content library. Use the following DCLI command:

> dcli> com vmware vcenter namespacemanagement lifecycle content libraries unassign --library <libraryId>

 

To decouple Supervisor updates from standard vCenter upgrades and configure them asynchronously, you must subscribe to the dedicated Broadcom content library source. This requires creating a separate, dedicated content library explicitly for Supervisor lifecycle management. A properly configured environment should contain two distinct content libraries like below: 

  • vks-library (For VKS Guest Cluster Control Plane/VM Service components)

    • Subscription URL: https://wp-content.vmware.com/v2/latest/lib.json

  • supervisor-library (For Supervisor images, assigned to Content Distribution -> Supervisor Images Library in Supervisor Management)

    • Subscription URL: https://wp-content.broadcom.com/supervisor/v1/latest/lib.json

The Broadcom documentation contains detailed steps on configuring a content library for Supervisor images.