Reference For: administrators

Licence errors

Causes and remedies for the error codes of licence limits, licence features and licence files.

error.licence.limit_running_vms

Text in the console
Power-on would exceed the running-VM licence limit ({current} of {limit}; requested {delta}). Power off unused virtual machines or install a licence.
Meaning for API clients
Power-on would exceed the running-VM licence limit.
Code
RESOURCE_EXHAUSTED, HTTP 429
ArgumentWhat it holds
limitthe limit of the licence.
currentthe number of virtual machines that run now.
deltathe number of virtual machines that the operation would start.

Cause. Powering on the virtual machine would take the number of running virtual machines over the limit of the effective licence. Powered-on, paused and suspended virtual machines count; powered-off virtual machines and templates do not.

Remedy.

  1. Power off virtual machines that are not needed: kyvernon vm power-off <id>.
  2. Or install a licence with a higher limit: kyvernon licence install <payload> <signature>. In the console, use Install licence.
  3. Check the counters: kyvernon licence show. The console shows them under Running virtual machines.

error.licence.limit_hosts

Text in the console
Enrolling a host would exceed the host licence limit ({current} of {limit}; requested {delta}). Remove a host or install a multi-host licence.
Meaning for API clients
Enrolling a host would exceed the host licence limit.
Code
RESOURCE_EXHAUSTED, HTTP 429
ArgumentWhat it holds
limitthe limit of the licence.
currentthe number of hosts now.
deltathe number of hosts that the operation would add.

Cause. Enrolling the host would take the number of hosts of the management domain over the limit of the effective licence.

Remedy.

  1. Remove a host that is not needed: kyvernon host destroy <id>.
  2. Or install a licence that allows more hosts: kyvernon licence install <payload> <signature>.
  3. Check the counters: kyvernon licence show. The console shows them under Hosts.

error.licence.feature_required

Text in the console
This operation needs the licence feature {feature}. Install a licence that includes it.
Meaning for API clients
The operation needs a licence feature that is not enabled.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentWhat it holds
featurethe feature that the operation needs.

Cause. The operation needs a licence feature that the effective licence does not include. The features are cluster, ha, live_migration, remote_storage.nfs, remote_storage.iscsi and remote_storage.ceph.

Remedy.

  1. Check which features are enabled: kyvernon licence show. In the console, see Features.
  2. Install a licence that includes the feature: kyvernon licence install <payload> <signature>.
  3. Or choose an operation that the current licence covers, for example a datastore on local storage.

error.licence.signature_invalid

Text in the console
The licence file signature is not valid. Check that you pasted the complete payload and signature.
Meaning for API clients
The licence file signature is not valid.
Code
FAILED_PRECONDITION, HTTP 412

Cause. The signature of the licence file does not match the payload, or was made with a key that this controller does not trust. The payload was changed after signing, or the signature file is incomplete.

Remedy.

  1. Install the payload and the signature exactly as you received them. Do not edit either file. Copy the complete content when you paste it in the console.
  2. Check that the signature file is the one that belongs to the payload.
  3. When it stays, ask the issuer of the licence for a new file. Pass on the licence identifier and the message id.

error.licence.not_valid

Text in the console
The licence is outside its validity window. Check the start and end dates on the licence file.
Meaning for API clients
The licence is outside its validity window.
Code
FAILED_PRECONDITION, HTTP 412

Cause. The licence is outside its validity window: its start date is still in the future, or its end date has passed. The clock of the controller decides.

Remedy.

  1. Read the start and end dates in the licence file and compare them with the date of the controller.
  2. When the controller clock is wrong, correct it, then install the licence again.
  3. When the licence has expired, ask the issuer for a new one and install it with kyvernon licence install <payload> <signature>.

Version 0.1. Last changed: 2026-11-13