Naslag Voor: beheerders

Licentiefouten

Oorzaken en oplossingen voor de foutcodes van licentielimieten, licentiefuncties en licentiebestanden.

error.licence.limit_running_vms

Tekst in de console
Inschakelen zou de limiet voor draaiende VM's overschrijden ({current} van {limit}; gevraagd {delta}). Schakel ongebruikte virtuele machines uit of installeer een licentie.
Betekenis voor API-clients
Power-on would exceed the running-VM licence limit.
Code
RESOURCE_EXHAUSTED, HTTP 429
ArgumentInhoud
limitde limiet van de licentie.
currenthet aantal virtuele machines dat nu draait.
deltahet aantal virtuele machines dat de bewerking zou starten.

Oorzaak. Door de virtuele machine in te schakelen zou het aantal draaiende virtuele machines boven de limiet van de geldende licentie uitkomen. Ingeschakelde, gepauzeerde en onderbroken virtuele machines tellen mee; uitgeschakelde virtuele machines en sjablonen niet.

Oplossing.

  1. Schakel virtuele machines uit die u niet nodig hebt: kyvernon vm power-off <id>.
  2. Of installeer een licentie met een hogere limiet: kyvernon licence install <payload> <signature>. In de console gebruikt u Licentie installeren.
  3. Controleer de tellers: kyvernon licence show. De console toont ze onder Draaiende virtuele machines.

error.licence.limit_hosts

Tekst in de console
Een host toevoegen zou de hostlimiet overschrijden ({current} van {limit}; gevraagd {delta}). Verwijder een host of installeer een multi-hostlicentie.
Betekenis voor API-clients
Enrolling a host would exceed the host licence limit.
Code
RESOURCE_EXHAUSTED, HTTP 429
ArgumentInhoud
limitde limiet van de licentie.
currenthet huidige aantal hosts.
deltahet aantal hosts dat de bewerking zou toevoegen.

Oorzaak. Door de host in te schrijven zou het aantal hosts van het beheerdomein boven de limiet van de geldende licentie uitkomen.

Oplossing.

  1. Verwijder een host die u niet nodig hebt: kyvernon host destroy <id>.
  2. Of installeer een licentie die meer hosts toestaat: kyvernon licence install <payload> <signature>.
  3. Controleer de tellers: kyvernon licence show. De console toont ze onder Hosts.

error.licence.feature_required

Tekst in de console
Deze bewerking vereist de licentiefunctie {feature}. Installeer een licentie die deze bevat.
Betekenis voor API-clients
The operation needs a licence feature that is not enabled.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
featurede functie die de bewerking nodig heeft.

Oorzaak. De bewerking vereist een licentiefunctie die de geldende licentie niet bevat. De functies zijn cluster, ha, live_migration, remote_storage.nfs, remote_storage.iscsi en remote_storage.ceph.

Oplossing.

  1. Controleer welke functies zijn ingeschakeld: kyvernon licence show. Zie in de console Functies.
  2. Installeer een licentie die de functie bevat: kyvernon licence install <payload> <signature>.
  3. Of kies een bewerking die de huidige licentie dekt, bijvoorbeeld een datastore op lokale opslag.

error.licence.signature_invalid

Tekst in de console
De handtekening van het licentiebestand is ongeldig. Controleer of u de volledige payload en handtekening hebt geplakt.
Betekenis voor API-clients
The licence file signature is not valid.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De handtekening van het licentiebestand komt niet overeen met de payload, of is gemaakt met een sleutel die deze controller niet vertrouwt. De payload is na het ondertekenen gewijzigd, of het handtekeningbestand is onvolledig.

Oplossing.

  1. Installeer de payload en de handtekening precies zoals u ze hebt ontvangen. Bewerk geen van beide bestanden. Kopieer de volledige inhoud wanneer u die in de console plakt.
  2. Controleer of het handtekeningbestand bij de payload hoort.
  3. Blijft de fout bestaan, vraag de uitgever van de licentie dan om een nieuw bestand. Geef de licentie-identificatie en het bericht-id door.

error.licence.not_valid

Tekst in de console
De licentie valt buiten het geldigheidsvenster. Controleer de begin- en einddatum op het licentiebestand.
Betekenis voor API-clients
The licence is outside its validity window.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De licentie valt buiten haar geldigheidsperiode: de begindatum ligt nog in de toekomst of de einddatum is verstreken. De klok van de controller beslist.

Oplossing.

  1. Lees de begin- en einddatum in het licentiebestand en vergelijk ze met de datum van de controller.
  2. Is de klok van de controller onjuist, corrigeer die dan en installeer de licentie opnieuw.
  3. Is de licentie verlopen, vraag de uitgever dan om een nieuwe en installeer die met kyvernon licence install <payload> <signature>.

Versie 0.1. Laatst gewijzigd: 2026-11-13