Problemen oplossen bij beheer

Elke sectie begint bij wat u ziet. De logboeken van de services staan in het journal: journalctl -u kyvernon-controller en journalctl -u kyvernon-agent. De controller schrijft standaard JSON-regels (format in [logging]).

Controller start niet

Oorzaak. De unit start niet zonder /etc/kyvernon/controller.toml. Een waarde buiten het toegestane bereik, een onbekende sleutel of een ontbrekend credentialbestand stopt de service bij het starten.

Oplossing.

1. Controleer de configuratie: sudo kyvernon-controller --config /etc/kyvernon/controller.toml check-config. Het bericht noemt de sleutel.
2. Lees de laatste regels van het journal: journalctl -u kyvernon-controller -n 50.
3. Vergelijk het bestand na een upgrade met het skelet /usr/share/kyvernon/controller.toml.example. De sleutels van de instellingen staan in Configuratie.

Controller niet gereed

Oorzaak. Liveness en readiness zijn verschillend. De controller leeft wanneer hij verzoeken afhandelt, en is gereed wanneer zijn store een leider heeft en zijn toestand is toegepast.

Oplossing.

1. Vraag beide op: kyvernon system health en kyvernon system ready. ready eindigt met code 1 wanneer de controller niet gereed is. Dezelfde controles zijn GET /healthz en GET /readyz.
2. Blijft de controller na een start niet gereed, lees dan het journal voor het bericht over de store.
3. kyvernon system metrics toont de metrics van de controller in Prometheus-tekstformaat (GET /metrics). Ze vragen een token, tenzij anonymous = true in [metrics].

Host maakt geen verbinding

Oorzaak. De agent registreert zich met het join-token en controleert de controller aan de hand van zijn certificaat. Een host die Niet verbonden toont nadat de agent is gestart, heeft meestal een van deze oorzaken: het join-token is onjuist of ontbreekt, het certificaat in controller-ca.pem is niet het bootstrapcertificaat van de controller, server_name is niet een van de namen in [tls] san van de controller, endpoint of de gRPC-poort van de controller is niet bereikbaar vanaf de host, de naam van de host verschilt van de naam die in het cluster is toegevoegd, of een beheerder heeft de verbinding met de host verbroken.

Oplossing.

1. Lees het journal op de host: sudo journalctl -u kyvernon-agent.service -n 50.
2. Vergelijk endpoint, ca_file, server_name en hostname in /etc/kyvernon/agent.toml met Installeren vanuit een offline depot, stap 3.
3. Controleer of /etc/kyvernon/join-token bestaat en gelijk is aan het token op de controller.
4. Een host die zijn certificaat kwijt is, bijvoorbeeld na een herinstallatie of door /var/lib/kyvernon/agent/identity te verwijderen, wordt onder dezelfde naam geweigerd. Voeg hem opnieuw toe met --force: Hosts.
5. Controleer of een beheerder de verbinding met de host heeft verbroken, en herstel de verbinding met Opnieuw verbinden.

Host reageert niet

Oorzaak. De controller toont Reageert niet wanneer er geen heartbeat meer binnenkomt van een host die verbonden was: de agent is gestopt, de host is uitgevallen of het netwerk ertussen is onderbroken. Virtuele machines op de host worden niet gestopt door een gestopte agent.

Oplossing.

1. Controleer de machine en de agent: systemctl status kyvernon-agent.service op de host.
2. Controleer het netwerk tussen de host en het gRPC-adres van de controller.
3. Start de agent opnieuw en controleer of de host Verbonden toont. Tot dan mislukken bewerkingen die de host nodig hebben, bijvoorbeeld de console met error.console.host_disconnected.

Inschakelen geweigerd

Oorzaak. De licentie of het geheugen van de host staat het niet toe. Het bericht-id noemt welke van de twee.

Oplossing.

1. error.licence.limit_running_vms: Licentie.
2. error.host.insufficient_memory, error.vm.exceeds_host_cpu of error.vm.exceeds_host_memory: Capaciteit.
3. error.host_in_maintenance: kies een andere host of verlaat de onderhoudsmodus.

Back-upsessie mislukt

Oorzaak. Een sessie eindigt als ABORTED of EXPIRED, of een verzoek wordt geweigerd met een backup.*-sleutel.

Oplossing. De reason van de sessie is een berichtsleutel. Een back-up van een virtuele machine maken geeft de sleutels die een client moet afhandelen en wat u bij elke sleutel doet.

Gegevens voor support

Geef bij contact met support het bericht-id van de fout door, de correlationId (ook in de header x-request-id van het antwoord), het tijdstip en de uitvoer van kyvernon about. De correlatie-id staat in de logboeken en in de auditrecords van het verzoek.

Zie ook

• Naslag van foutcodes
• Configuratie