Naslag Voor: beheerders

Back-upfouten

Oorzaken en oplossingen voor de foutcodes van de back-uprepository, van back-ups en herstel door de controller en van controllerarchieven.

error.backup.no_repository

Tekst in de console
Er is geen back-uprepository ingesteld op de controller.
Betekenis voor API-clients
No backup repository is configured on the controller ([backup] verify_repository or the backup settings).
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. De controller heeft geen back-uprepository en heeft dus geen back-uppunten om te tonen of te herstellen. De repository is de map waarin back-upsoftware de back-ups voor de controller schrijft (een map per virtuele machine en per back-up, met een manifest en een raw image per schijf).

Oplossing.

  1. Stel de map in: kyvernon backup settings set --repository /srv/backup-repo, of in de console bij de back-upinstellingen. De instelling verify_repository in de sectie [backup] van de controllerconfiguratie is de standaardwaarde.
  2. Gebruik bij meer dan één controller gedeelde opslag die op elke controller onder hetzelfde pad is gekoppeld.
  3. Controleer het resultaat: kyvernon backup repository.

error.backup.repository_unusable

Tekst in de console
De repository {repository} kan op deze controller niet worden aangemaakt of beschreven.
Betekenis voor API-clients
The repository directory cannot be created or written on this controller.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
repositoryde geweigerde map.

Oorzaak. De map van de repository uit de back-upinstellingen kan niet worden aangemaakt, of de controllerservice mag er niet in schrijven.

Oplossing.

  1. Controleer of het pad bestaat of dat de bovenliggende map schrijfbaar is voor de controllerservice, en of het bestandssysteem gekoppeld is.
  2. Geef de controllerservice schrijfrechten op de map en sla de instellingen opnieuw op: kyvernon backup settings set --repository <dir>.

error.backup.export_unreachable

Tekst in de console
De controller kan de export van een schijf op de host niet bereiken.
Betekenis voor API-clients
The controller cannot reach the NBD export of a disk on the host.
Code
UNAVAILABLE, HTTP 503

Oorzaak. Bij een back-up leest de controller elke schijf via de export die de host ervoor opent. De controller bereikte noch de socket van de export op zijn eigen machine, noch het netwerkadres van de export. Zonder remote_exports in de sectie [backup] zijn exports lokale sockets op de host, die alleen een controller op dezelfde machine bereikt.

Oplossing.

  1. Zet voor een controller op een andere machine dan de host remote_exports = true in de sectie [backup] van de controllerconfiguratie en herstart hem; exports gaan dan via TCP met TLS en de certificaatvingerafdruk van de host.
  2. Controleer of de exportpoort van de host vanaf de controller bereikbaar is.
  3. Start de back-up opnieuw: kyvernon vm backup <vm>.

error.backup.change_tracking

Tekst in de console
Wijzigingsregistratie kon voor {vm} niet worden ingeschakeld.
Betekenis voor API-clients
Change tracking could not be turned on for the virtual machine before its first backup.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
vmde virtuele machine.

Oorzaak. Een back-up leest alleen de gewijzigde delen van een schijf en heeft wijzigingsregistratie op de virtuele machine nodig. De controller zet die vóór de eerste back-up aan, en die wijziging mislukte.

Oplossing.

  1. Bekijk de reden in de mislukte herconfiguratietaak van de virtuele machine: kyvernon tasks list --entity <vm>.
  2. Zet wijzigingsregistratie zelf aan in de instellingen van de virtuele machine en start de back-up opnieuw.

error.backup.no_disks

Tekst in de console
{vm} heeft geen schijf om te back-uppen.
Betekenis voor API-clients
The virtual machine has no disk to back up.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
vmde virtuele machine.

Oorzaak. De virtuele machine heeft geen virtuele schijf; er valt niets te back-uppen.

Oplossing.

  1. Voeg een schijf toe aan de virtuele machine, of laat haar buiten het back-upschema door een smaller bereik te kiezen.

error.backup.vm_powered_on

Tekst in de console
{vm} staat aan. Zet de VM uit voor een herstel ter plaatse: het herstel vervangt de schijven.
Betekenis voor API-clients
A restore in place replaces the disks of the virtual machine; it must be powered off.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
vmde virtuele machine.

Oorzaak. Een herstel ter plaatse vervangt de schijven van de virtuele machine waar het back-uppunt vandaan komt. Dat gebeurt alleen als de virtuele machine uit staat.

Oplossing.

  1. Sluit het gastsysteem af en zet de virtuele machine uit: kyvernon vm shutdown <vm>.
  2. Start het herstel opnieuw: kyvernon backup restore-point <point> --in-place.
  3. Wilt u de virtuele machine laten draaien, herstel dan naar een nieuwe virtuele machine (zonder --in-place).

error.backup.verify_failed

Tekst in de console
Het herstel is klaar, maar backuppunt {point} is niet door de controle in quarantaine gekomen.
Betekenis voor API-clients
The restore finished, but the verification of the backup point in quarantine failed.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
pointhet gecontroleerde back-uppunt.

Oorzaak. Het herstel is klaar, maar de gevraagde controle mislukte: een aparte virtuele machine van het back-uppunt op het quarantainenetwerk startte geen besturingssysteem, kreeg geen adres of antwoordde niet op tijd op een gevraagde poort. De herstelde virtuele machine blijft zoals ze is.

Oplossing.

  1. Lees het resultaat van de controle in de taak of in het rapport: kyvernon backup verification report. De reden noemt het ontbrekende bewijs.
  2. Controleer de herstelde virtuele machine voordat u haar gebruikt, of herstel een ouder back-uppunt.
  3. Controleer een traag startend gastsysteem opnieuw met een langere time-out.

error.backup.controller_running

Tekst in de console
Er loopt al een back-up van de controllerstatus.
Betekenis voor API-clients
A backup of the controller state is already running.
Code
CONFLICT, HTTP 409

Oorzaak. Er wordt al een archief van de controllerstatus geschreven; er loopt er één tegelijk.

Oplossing.

  1. Wacht tot het klaar is: kyvernon system controller-backups toont de laatste run.

error.backup.controller_target

Tekst in de console
De map {target} voor de controllerarchieven kan niet worden aangemaakt.
Betekenis voor API-clients
The folder for the archives of the controller state cannot be created.
Code
FAILED_PRECONDITION, HTTP 412
ArgumentInhoud
targetde map.

Oorzaak. De map voor de archieven van de controllerstatus kan niet worden aangemaakt, of de controllerservice mag er niet in schrijven.

Oplossing.

  1. Controleer de map onder controller_target in de sectie [backup] van de controllerconfiguratie (standaard: controller-backups naast de statusmap).
  2. Geef de controllerservice schrijfrechten, of kies een andere map en herstart de controller.

error.backup.controller_changed

Tekst in de console
{file} veranderde tijdens het archiveren. Start de back-up opnieuw.
Betekenis voor API-clients
A file of the state directory changed while it was archived.
Code
CONFLICT, HTTP 409
ArgumentInhoud
filehet bestand in het archief.

Oorzaak. Een bestand in de statusmap, buiten de twee databases, veranderde terwijl het archief werd geschreven; het archief zou het bestand niet bevatten zoals het gecontroleerd is. De databases worden gekopieerd uit één consistente leesactie en vallen hier buiten.

Oplossing.

  1. Start de back-up opnieuw: kyvernon system controller-backup --wait.
  2. Mislukt het steeds op hetzelfde bestand, zoek dan uit wat ernaar schrijft (de fout noemt het bestand).

error.backup.controller_unreadable

Tekst in de console
Het archief van de controllerstatus leest niet terug zoals het geschreven is; het is niet bewaard.
Betekenis voor API-clients
The archive that was written does not read back as written.
Code
INTERNAL, HTTP 500

Oorzaak. Na het schrijven leest de controller elk archief terug en controleert elk bestand met zijn controlesom. Dit archief las niet terug zoals het geschreven is; het is verwijderd en de oudere archieven blijven. Meestal is de schijf onder de archiefmap vol of defect.

Oplossing.

  1. Controleer de vrije ruimte en de staat van de schijf onder de archiefmap.
  2. Start de back-up opnieuw: kyvernon system controller-backup --wait.

error.backup.controller_unavailable

Tekst in de console
Deze controller houdt zijn status in het geheugen; er valt niets te archiveren.
Betekenis voor API-clients
This controller keeps its state in memory; there is nothing to archive.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. Deze controller houdt zijn database in het geheugen (een test- of ontwikkelopstelling); er is geen statusmap om te archiveren.

Oplossing.

  1. Draai de controller met zijn statusmap (data_dir van controller.toml) om archieven te maken.

error.backup.source_gone

Tekst in de console
De virtuele machine van dit back-uppunt bestaat niet meer; de configuratie ervan is nodig voor een herstel.
Betekenis voor API-clients
The virtual machine of the backup point no longer exists; its configuration is needed for a restore.
Code
FAILED_PRECONDITION, HTTP 412

Oorzaak. Een back-uppunt wordt hersteld met de configuratie van de virtuele machine (processors, geheugen, netwerkadapters), en die virtuele machine bestaat niet meer.

Oplossing.

  1. Maak een virtuele machine met de gewenste configuratie, en herstel daarin de schijven van het back-uppunt met de back-upsoftware.
  2. Bewaar virtuele machines waarvan u de back-ups nog nodig kunt hebben, of bewaar een sjabloon van hun configuratie.

Versie 0.1. Laatst gewijzigd: 2026-11-14