Error "License key(s) could not be added to vCenter system(s)" When Adding vCenter License in Aria Operations
search cancel

Error "License key(s) could not be added to vCenter system(s)" When Adding vCenter License in Aria Operations

book

Article ID: 391099

calendar_today

Updated On:

Products

VMware Aria Suite

Issue/Introduction

  • Users may encounter the error "License key(s) could not be added to vCenter system(s)" when attempting to add a vCenter license key within Aria Operations.

  • The logs from the Infrastructure Health Adapter (/storage/log/vcops/log/adapters/VMwareInfraHealthAdapter/VMwareInfraHealthAdapter_ID.log) report multiple cases where the user/service account does not have the required privilege for collecting licensing info: 

    2025-03-06T03:14:37,281+0000 ERROR [pool-91402-thread-3] (52) com.vmware.adapter3.vmwareinfrahealth.helpers.vcenter.collector.VCenterLicenseUsageCollector.collect - The configured User account for the VC endpoint xxxxx.xxx.xxxxx.com is missing the required permission Global.Licenses. License collection will not be performed.
    2025-03-06T03:19:20,682+0000 ERROR [pool-91413-thread-8] (52) com.vmware.adapter3.vmwareinfrahealth.helpers.vcenter.collector.VCenterLicenseUsageCollector.collect - The configured User account for the VC endpoint xxxxx.xxx.xxxxx.com is missing the required permission Global.Licenses. License collection will not be performed.
    2025-03-06T03:19:20,729+0000 ERROR [pool-91413-thread-2] (52) com.vmware.adapter3.vmwareinfrahealth.helpers.vcenter.collector.VCenterLicenseUsageCollector.collect - The configured User account for the VC endpoint xxxxx.xxx.xxxxx.com is missing the required permission Global.Licenses. License collection will not be performed.
    2025-03-06T03:19:21,308+0000 ERROR [pool-91413-thread-7] (52) com.vmware.adapter3.vmwareinfrahealth.helpers.vcenter.collector.VCenterLicenseUsageCollector.collect - The configured User account for the VC endpoint xxxxx.xxx.xxxxx.com is missing the required permission Global.Licenses. License collection will not be performed.

Environment

  • VMware Aria Operations 8.18.x

Cause

  • The error occurs due to insufficient permissions assigned to the vCenter service account used by Aria Operations. 

  • Additionally, the vCenter version must be compatible (8.0 Update 2b or higher) to allow license key addition from Aria Operations.

Resolution

  • Verify vCenter Version: Ensure the vCenter Server version is 8.0 Update 2b or later.

  • Grant Global.Licenses Privilege: In vCenter, navigate to Home > Administration > Access Control > Roles page and verify that the service account has the global privilege Global.Licenses.

  • Verify and ensure that the respective 'Role' is assigned to the 'User' in Home > Administration > Access Control > Global Permissions page

  • Add to Administrators Group: In vCenter, navigate to Home > Administration > Single Sign On > Users and Groups > Groups page and add the service account to either the LicenseService.Administrators or SSO's Administrators group.

  • The Edit page appears.

  • Add the vCenter service account 'User' in the 'Administrators' group and save the changes.

  • Retry License Addition: After granting the necessary permissions, attempt to add the vCenter license key in Aria Operations again.

  • This time the vCenter license addition operation should be successful.

Additional Information

  • The vCenter version must meet the minimum requirement.

  • Always ensure that the service account used for integration has the correct privileges and group memberships.

  • Reference vCenter and Aria Operations documentation for detailed permission configurations when dealing with license integrations. Managing Licenses