Consolefouten

Oorzaken en oplossingen voor de foutcodes bij het uitgeven of gebruiken van een consoleticket.

`error.console.powered_off`

Tekst in de console: De virtuele machine is uitgeschakeld.
Betekenis voor API-clients: The VM is powered off; a console needs a running VM.
Code: FAILED_PRECONDITION, HTTP 412

Oorzaak. Er is een consoleticket aangevraagd voor een virtuele machine die niet is ingeschakeld en niet is onderbroken. Een console heeft een draaiende virtuele machine nodig.

Oplossing.

Schakel de virtuele machine in: kyvernon vm power-on <id>. Gebruik in de console Inschakelen.
Open de console opnieuw met Console openen.

`error.console.not_available`

Tekst in de console: Deze virtuele machine heeft geen grafische console.
Betekenis voor API-clients: The VM runs without a graphical console (no console.vnc).
Code: FAILED_PRECONDITION, HTTP 412

Oorzaak. De hostagent meldde dat de virtuele machine zonder grafische console draait, bijvoorbeeld omdat ze een runtime gebruikt zonder VNC-weergave.

Oplossing.

Gebruik in plaats daarvan de seriële console: kyvernon vm serial-log <id> toont het einde van het seriële logboek. Gebruik in de console Serieel logboek.
Is een grafische console nodig, dan wijzigt een beheerder de runtime van de virtuele machine. Geef de bericht-id error.console.not_available en de naam van de virtuele machine door.

`error.console.host_disconnected`

Tekst in de console: De host van de virtuele machine is niet verbonden.
Betekenis voor API-clients: The VM's host is not connected.
Code: UNAVAILABLE, HTTP 503

Oorzaak. De host waarop de virtuele machine draait is niet verbonden met de controller, dus de console is niet bereikbaar.

Oplossing.

Controleer de status van de host in de inventaris en probeer het opnieuw zodra de host is verbonden.
Een beheerder controleert de host en zijn agent. Een host die bewust is losgekoppeld, blijft losgekoppeld totdat kyvernon host reconnect <id> wordt uitgevoerd. Geef de naam van de virtuele machine en het tijdstip van de fout door.

`error.console.rate_limited`

Tekst in de console: Te veel consoletickets. Probeer het over {retryAfterSeconds} seconden opnieuw.
Betekenis voor API-clients: Too many console tickets for this session.
Code: RESOURCE_EXHAUSTED, HTTP 429

Argument	Inhoud
`retryAfterSeconds`	de seconden die moeten verstrijken voordat een nieuw ticket wordt uitgegeven.

Oorzaak. De sessie heeft binnen één minuut meer dan 20 consoletickets gevraagd. Kyvernon beperkt de tickets per sessie.

Oplossing.

Wacht het aantal seconden uit het bericht.
Hergebruik de console die al open is in plaats van telkens een nieuwe te openen. Een ticket is 30 seconden geldig en werkt één keer.

`error.console.ticket_invalid`

Tekst in de console: Het consoleticket is ongeldig, al gebruikt of verlopen.
Betekenis voor API-clients: The console ticket is unknown, used or expired.
Code: UNAUTHENTICATED, HTTP 401

Oorzaak. Het consoleticket is onbekend, is al gebruikt of is ouder dan 30 seconden. Een ticket werkt één keer en alleen voor de sessie die het heeft aangevraagd.

Oplossing.

Vraag een nieuw ticket aan en verbind direct: kyvernon vm console ticket <id>. Gebruik in de console opnieuw Console openen.
Bewaar of deel tickets niet. Een nieuwe verbinding heeft altijd een nieuw ticket nodig.