Kyvernon

Werkwijze Voor: beheerders

Hosts

Een host aan een cluster toevoegen, in onderhoudsmodus zetten, loskoppelen en opnieuw koppelen, herstarten of afsluiten en verwijderen.

Een host is een machine waarop de hostagent en Kyvernon VMM draaien en die virtuele machines draagt. De console toont de verbinding onder Verbinding: Verbonden, Niet verbonden of Reageert niet. Elke onderstaande actie start een taak die de console meldt in Taken.

Installeer de hostpakketten en schrijf de agentinstellingen zoals beschreven in Installeren vanuit een offline depot, stap 3. Een agent die in zijn instellingen een cluster noemt, voegt zich bij het eerste contact zelf bij dat cluster; deze pagina beschrijft het toevoegen van de host eerst vanaf de controller. Controleer de licentie: de gratis laag staat één host toe en een extra host vraagt een licentie die meer hosts toestaat en de functie cluster bevat; anders mislukt het verzoek met error.licence.limit_hosts of error.licence.feature_required. Zie Licentie.

In de console

Een host toevoegen

Een host toevoegen maakt een wachtende host in een cluster. Die blijft losgekoppeld totdat de agent op die machine zich onder dezelfde naam registreert met het join-token.

  1. Selecteer in de inventaris het cluster en selecteer Host toevoegen.

    Venster Host toevoegen met hostnaam en beheeradres (Groter weergeven)
  2. Vul de naam van de host in bij Hostnaam. Die moet gelijk zijn aan de hostnaam in de agentinstellingen van die machine, wat de hostnaam van de machine is wanneer er geen is ingesteld.
  3. Vul Beheeradres in wanneer de controller de host op een ander adres dan zijn naam moet bereiken.
  4. Selecteer Host toevoegen. Het dialoogvenster De agent van ... verbinden toont wat de agent nodig heeft: het Join-token, dat Tonen zichtbaar maakt, het Certificaat van de controller dat de host vertrouwt en de Agentinstellingen, die Instellingen kopiëren kopieert.
  5. Schrijf op de machine het token en de instellingen zoals het dialoogvenster zegt en start dan de agent. De host verandert in Verbonden wanneer hij is geregistreerd.

Een controller die het token niet toont, toont Deze controller toont het join-token niet. Lees het op de controller uit /etc/kyvernon/join-token.

Een host in onderhoudsmodus zetten

Een host in onderhoudsmodus krijgt geen nieuwe virtuele machines. Erin gaan wordt geweigerd zolang een virtuele machine op de host is ingeschakeld of onderbroken (error.host_has_running_vms): Kyvernon verplaatst virtuele machines niet voor u. Verplaats ze eerst met Migreren (livemigratie vraagt de licentiefunctie live_migration), of schakel ze uit.

  1. Selecteer de host en selecteer Onderhoudsmodus starten. Dezelfde actie staat op het tabblad Configureren, onderdeel Onderhoud.

    Onderhoudsmodus van een host (Groter weergeven)
  2. De status verschijnt als In onderhoudsmodus.
  3. Selecteer Onderhoudsmodus beëindigen om te stoppen.

Een host loskoppelen en opnieuw koppelen

Een losgekoppelde host blijft losgekoppeld totdat u hem opnieuw koppelt: heartbeats en een nieuwe registratie van zijn agent veranderen dat niet. Virtuele machines erop blijven draaien. Gebruik het vóór werk aan de machine dat niet voor een storing moet worden aangezien.

  1. Selecteer de host en dan Meer acties.

    Het menu Meer acties van een host (Groter weergeven)

  2. Selecteer Verbinding verbreken en bevestig.

    Venster Host loskoppelen (Groter weergeven)
  3. Selecteer Meer acties en dan Opnieuw verbinden om te stoppen.

Een host herstarten of afsluiten

Beide acties staan in Meer acties en zijn alleen beschikbaar in onderhoudsmodus, zodat er geen virtuele machine op de host draait.

  1. Zet de host in onderhoudsmodus zoals hierboven.
  2. Selecteer Herstarten of Afsluiten en typ de naam van de host om te bevestigen.
  3. Vink Niet op de gasten wachten alleen aan wanneer de host niet op het einde van processen mag wachten.

De console roept de eigen routes van de controller aan, die het verzoek weigeren tenzij de host in onderhoudsmodus staat; de hostagent moet melden dat hij zijn machine kan herstarten, anders antwoordt het controlevlak met error.host_capability_missing. De actie vereist de bevoegdheid Host.Config.Maintenance op de host, en een weigering noemt de voorwaarde die niet klopte. Beide acties zijn taken die u in het takenvenster volgt.

Na een herstart is een host niet beschikbaar totdat hij weer is opgestart, en zijn agent verbindt zichzelf opnieuw. Een afgesloten host blijft uit totdat iemand hem start op de machine of via zijn beheercontroller.

Een host verwijderen

Alleen een host waarop geen virtuele machines zijn geplaatst, ook geen uitgeschakelde, kan worden verwijderd (error.host_has_vms). Verplaats of verwijder ze eerst. De actie is niet beschikbaar zolang er virtuele machines op zijn geplaatst, met de melding Verplaats of vernietig eerst elke VM op deze host.

  1. Selecteer de host en dan Meer acties.
  2. Selecteer Host verwijderen, typ de naam van de host en bevestig.

De host verlaat zijn cluster en de inventaris. Zijn agent moet zich opnieuw aanmelden met het join-token om terug te komen.

Resultaat

De host toont de nieuwe status in de inventaris, op zijn overzicht en op het tabblad Configureren.

Overzicht van een host met status, hardware en acties (Groter weergeven)

Automatisering

Met de CLI

Voeg een host toe. --force geeft een bestaande host met dezelfde naam terug in plaats van te mislukken. Voor een host die al in dit cluster is geregistreerd, zet --force hem terug: zijn certificaat wordt ingetrokken en de agent moet zich opnieuw aanmelden met het join-token. Start daarna de agent op de machine met sudo systemctl enable --now kyvernon-agent.service:

Shell
kyvernon cluster add-host domain-c10 --name host-02.example.com \
  --management-address 192.0.2.12 --wait

Koppel los en opnieuw, ga in onderhoudsmodus en verlaat die, herstart of sluit af in onderhoudsmodus, en verwijder een host. --wait wacht op de taak:

Shell
kyvernon host disconnect host-3 --wait
kyvernon host reconnect host-3 --wait
kyvernon host enter-maintenance host-3 --wait
kyvernon host exit-maintenance host-3 --wait
kyvernon host reboot host-3 --wait
kyvernon host shutdown host-3 --wait
kyvernon host destroy host-3 --wait

Om vóór het onderhoud een virtuele machine te verplaatsen: kyvernon vm relocate <id> --host <host>. Het record dat kyvernon inventory host <id> toont, meldt ook de hardware die de agent vond (hardware) en het huidige gebruik (runtime).

Met de API

ActieVerzoek
Een host toevoegenPOST /v1/clusters/{id}/hosts met {"name": "host-02.example.com", "managementAddress": "192.0.2.12"}; "force": true heeft het hierboven beschreven effect
Loskoppelen, opnieuw koppelenPOST /v1/hosts/{id}/disconnect, POST /v1/hosts/{id}/reconnect
Onderhoudsmodus in, uitPOST /v1/hosts/{id}/enter-maintenance, POST /v1/hosts/{id}/exit-maintenance
Herstarten, afsluitenPOST /v1/hosts/{id}/reboot, POST /v1/hosts/{id}/shutdown, met {"force": true} om de eis van onderhoudsmodus over te slaan
VerwijderenDELETE /v1/hosts/{id}

Elke aanroep antwoordt met de taak. Een geweigerd onderhoudsverzoek antwoordt 412 met het bericht-id van de oorzaak. Herstarten en afsluiten zonder force antwoorden 412 met error.host.not_in_maintenance zolang de host niet in onderhoudsmodus staat.

  • Clusters voor de instellingen van het cluster waartoe een host behoort.
  • Hostfouten voor oorzaken en oplossingen van de bovenstaande foutcodes.
  • Problemen oplossen wanneer een host niet verbindt.

Versie 0.1. Laatst gewijzigd: 2026-11-14