vSAN License application failure after VCF or VVF renewal or upgrade
Article ID: 440956
Updated On:
Products
Issue/Introduction
Administrators may encounter "insufficient capacity" errors when attempting to apply renewed vSAN licenses across multiple clusters. This article addresses issues where vCenter fails to aggregate standalone vSAN capacity licenses with core-based storage entitlements from VMware vSphere Foundation (VVF) or VMware Cloud Foundation (VCF). It provides the necessary steps to consolidate entitlements into a unified license key.
Symptoms
- You are unable to apply renewed or upgraded additional vSAN storage licenses across infrastructure clusters to cover total capacity.
- The issue often occurs when attempting to license a second or third cluster in the environment.
- Validation errors appear in vCenter: "The license capacity is insufficient."
- vCenter deducts the full raw capacity of the cluster from the license key instead of applying the expected core-based entitlement offset (e.g., 1 TiB per core).
- The combined total of the standalone key and VVF/VCF entitlements matches the raw cluster capacity, but the system treats them as separate, non-aggregating pools.
Environment
- VMware Cloud Foundation (VCF)
- VMware vSphere Foundation (VVF)
- VMware vSAN 8.x
- VMware vCenter Server 8.x
Cause
The issue is caused by an asset-type incompatibility within the license management architecture. You cannot dynamically aggregate or "stack" a standalone vSAN capacity license (measured in Terabytes/Tibibytes) with the core-bound storage entitlements bundled inside a VVF license. Because the platform treats these as fundamentally different license types, they cannot coexist to cover a single continuous storage deployment, resulting in unassigned capacity.
Resolution
To resolve this capacity mismatch, you must consolidate your entitlements into a single, unified license type.
- Engage Support: Open a non-technical support case with the Global Customer Assistance (GCA) team.
- Entitlement Review: Provide your environment details to GCA. They review your entitlements and isolate the compatible assets.
- Consolidate Keys: Once GCA identifies the correct keys, follow the official process in the Broadcom Support Portal to merge or split your VMware license keys.
- Apply Unified Key: Generate a single, continuous capacity key that fulfills your total deployment requirement (e.g., #### TiB)
- Apply the consolidated license key to your cluster(s).
Creating a unified key replaces the asset mismatch with a single consolidated product type, allowing the management interface to validate the full storage footprint and restore the environment to a healthy, licensed state.
Additional Information
Feedback
