Naslag Voor: beheerders

Hostfouten

Oorzaken en oplossingen voor de foutcodes van hosts: geheugen, mogelijkheden, onderhoudsmodus en verwijdering.

error.host.insufficient_memory

Tekst in de console
Host {host} heeft {available} MiB geheugen vrij voor virtuele machines; deze heeft {requested} MiB nodig. Schakel andere virtuele machines uit, geef deze minder geheugen of verplaats haar naar een andere host.
Betekenis voor API-clients
Power-on refused: the host has available MiB free for virtual machines, the guest needs requested.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
requestedhet geheugen in MiB dat de virtuele machine nodig heeft.
availablehet geheugen in MiB dat de host vrij heeft voor virtuele machines.
hostde naam van de host.

Oorzaak. Het inschakelen is geweigerd, omdat de host minder geheugen vrij heeft voor virtuele machines dan de virtuele machine nodig heeft. Vrij geheugen is het geheugen van de host, min de reserve die de host voor zichzelf houdt (host_memory_reserve_mib in de sectie [vm_ops], standaard 2048 MiB), min het geheugen van de virtuele machines die erop draaien. De instelling memory_overcommit_ratio in dezelfde sectie staat toe dat de draaiende virtuele machines dat bedrag overschrijden; de standaardwaarde 1.0 betekent geen overcommit.

Oplossing.

  1. Schakel virtuele machines uit die op die host niet nodig zijn: kyvernon vm power-off <id>.
  2. Geef de virtuele machine minder geheugen: Instellingen bewerken.
  3. Verplaats de virtuele machine naar een host met meer vrij geheugen: kyvernon vm relocate <id> --host <host>.

error.host.not_in_maintenance

Tekst in de console
Host {host} staat niet in onderhoudsmodus. Zet de host eerst in onderhoudsmodus, of forceer de herstart of het afsluiten.
Betekenis voor API-clients
Reboot or shutdown needs the host in maintenance mode (or force).
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
hostde naam van de host.

Oorzaak. Er is gevraagd een host te herstarten of af te sluiten terwijl de host niet in onderhoudsmodus staat. Een host in onderhoudsmodus draait geen virtuele machines, dus er stopt niets mee.

Oplossing.

  1. Zet de host eerst in onderhoudsmodus: kyvernon host enter-maintenance <id> --wait. Gebruik in de console Onderhoudsmodus starten.
  2. Herstart daarna: kyvernon host reboot <id>, of sluit af: kyvernon host shutdown <id>. Gebruik in de console Herstarten.
  3. Als de virtuele machines op de host mee mogen stoppen, forceer de actie: kyvernon host reboot <id> --force.

error.host.not_connected

Tekst in de console
Host {host} is niet verbonden met het beheerplatform. Probeer het opnieuw als de host weer verbonden is.
Betekenis voor API-clients
The host is not connected to the control plane.
Code
UNAVAILABLE, HTTP 503
ArgumentInhoud
hostde naam van de host.

Oorzaak. De bewerking heeft de agent van de host nodig, en de host is niet verbonden met het beheerplatform: een beheerder heeft de verbinding verbroken, de host reageert niet, of de agent heeft zich nog niet aangemeld.

Oplossing.

  1. Bekijk de verbindingsstatus van de host: kyvernon inventory host <id>.
  2. Een host die een beheerder heeft losgekoppeld, komt terug met kyvernon host reconnect <id>.
  3. Een host die niet reageert, heeft een draaiende agent en een netwerkverbinding met de controller nodig: controleer de service kyvernon-agent op de host.

error.host_capability_missing

Tekst in de console
De host biedt de mogelijkheid {capability} niet. Kies een andere host of werk de hostagent bij.
Betekenis voor API-clients
The host did not declare the needed capability.
Code
UNIMPLEMENTED, HTTP 501
ArgumentInhoud
capabilityde mogelijkheid die de host mist.

Oorzaak. De bewerking heeft een mogelijkheid nodig die de host niet heeft gemeld. Het onderbreken van een virtuele machine vraagt suspend-to-disk, het wijzigen van de vCPU's, het geheugen of de apparaten van een draaiende virtuele machine vraagt hotplug, en livemigratie vraagt live-migration op beide hosts.

Oplossing.

  1. Kies een host die de mogelijkheid biedt. De mogelijkheden van een host staan in zijn record: kyvernon inventory host <id>.
  2. Werk de hostagent bij naar een versie die de mogelijkheid meldt en verbind de host opnieuw.
  3. Schakel de virtuele machine eerst uit voor een wijziging van de vCPU's, het geheugen of de apparaten.

error.host_has_running_vms

Tekst in de console
De host heeft nog actieve of onderbroken VM's; schakel ze eerst uit of evacueer ze
Betekenis voor API-clients
Maintenance mode needs the host's VMs powered off or moved.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De host kan de onderhoudsmodus niet ingaan zolang er virtuele machines op draaien of zijn onderbroken.

Oplossing.

  1. Verplaats de virtuele machines naar een andere host met Migreren, of schakel ze uit.
  2. Ga de onderhoudsmodus opnieuw in: kyvernon host enter-maintenance <id>. Gebruik in de console Onderhoudsmodus starten.

error.host_has_vms

Tekst in de console
De host heeft nog VM's; verplaats of vernietig ze eerst
Betekenis voor API-clients
The host still has VMs placed on it; relocate or destroy them first.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. Een host waarop virtuele machines zijn geplaatst, kan niet worden verwijderd. Dit omvat uitgeschakelde virtuele machines.

Oplossing.

  1. Verplaats elke virtuele machine naar een andere host: kyvernon vm relocate <id> --host <host>. Virtuele machines die niet meer nodig zijn, kunnen worden verwijderd.
  2. Verwijder de host: kyvernon host destroy <id>. Gebruik in de console Host verwijderen.

error.host_in_maintenance

Tekst in de console
De host staat in onderhoudsmodus
Betekenis voor API-clients
The host is in maintenance mode.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De bewerking plaatst een virtuele machine op een host die in onderhoudsmodus staat. Een host in onderhoudsmodus krijgt geen nieuwe virtuele machines.

Oplossing.

  1. Kies een andere host.
  2. Of beëindig de onderhoudsmodus: kyvernon host exit-maintenance <id>. Gebruik in de console Onderhoudsmodus beëindigen.

Versie 0.1. Laatst gewijzigd: 2026-11-13