Cause. Le contrôleur n'a pas de référentiel de sauvegarde ; il n'a donc aucun point de sauvegarde à lister, à prendre ou à restaurer. Le référentiel est le répertoire dans lequel le contrôleur écrit ses sauvegardes, et dans lequel un autre logiciel de sauvegarde peut aussi écrire (un dossier par machine virtuelle et par sauvegarde, avec un manifeste et une image brute par disque).
Solution.
Indiquez le répertoire : kyvernon backup settings set --repository /srv/backup-repo, ou dans la console sous les paramètres de sauvegarde. Le paramètre verify_repository de la section [backup] de la configuration du contrôleur sert de valeur par défaut.
Avec plusieurs contrôleurs, utilisez un stockage partagé monté au même chemin sur chacun.
Vérifiez le résultat : kyvernon backup repository.
error.backup.repository_unusable
Texte dans la console
Le référentiel {repository} ne peut pas être créé ni écrit sur ce contrôleur.
Signification pour les clients de l'API
The repository directory cannot be created or written on this controller.
Cause. Le répertoire du référentiel indiqué dans les paramètres de sauvegarde ne peut pas être créé, ou le service du contrôleur ne peut pas y écrire.
Solution.
Vérifiez que le chemin existe ou que son parent est accessible en écriture au service du contrôleur, et que le système de fichiers est monté.
Donnez au service du contrôleur l'accès en écriture au répertoire, puis enregistrez de nouveau les paramètres : kyvernon backup settings set --repository <dir>.
error.backup.export_unreachable
Texte dans la console
Le contrôleur ne peut pas joindre l'export d'un disque sur l'hôte.
Signification pour les clients de l'API
The controller cannot reach the NBD export of a disk on the host.
Cause. Pendant une sauvegarde, le contrôleur lit chaque disque par l'export que l'hôte ouvre pour lui. Le contrôleur n'a joint ni le socket de l'export sur sa propre machine, ni l'adresse réseau de l'export. Sans remote_exports dans la section [backup], les exports sont des sockets locaux de l'hôte, que seul un contrôleur sur la même machine peut joindre.
Solution.
Pour un contrôleur sur une autre machine que l'hôte, indiquez remote_exports = true dans la section [backup] de la configuration du contrôleur et redémarrez-le ; les exports passent alors par TCP avec TLS et l'empreinte du certificat de l'hôte.
Vérifiez que le port d'export de l'hôte est joignable depuis le contrôleur.
Relancez la sauvegarde : kyvernon vm backup <vm>.
error.backup.change_tracking
Texte dans la console
Le suivi des modifications n'a pas pu être activé pour {vm}.
Signification pour les clients de l'API
Change tracking could not be turned on for the virtual machine before its first backup.
Cause. Une sauvegarde ne lit que les zones modifiées d'un disque et a besoin du suivi des modifications sur la machine virtuelle. Le contrôleur l'active avant la première sauvegarde, et cette modification a échoué.
Solution.
Consultez la raison dans la tâche de reconfiguration de la machine virtuelle qui a échoué : kyvernon tasks list --entity <vm>.
Activez vous-même le suivi des modifications dans les paramètres de la machine virtuelle, puis relancez la sauvegarde.
Cause. Une restauration sur place remplace les disques de la machine virtuelle d'où vient le point de sauvegarde. Elle n'a lieu que lorsque la machine virtuelle est hors tension.
Solution.
Arrêtez le système invité et mettez la machine virtuelle hors tension : kyvernon vm shutdown <vm>.
Relancez la restauration : kyvernon backup restore-point <point> --in-place.
Pour garder la machine virtuelle en marche, restaurez plutôt vers une nouvelle machine virtuelle (sans --in-place).
error.backup.verify_failed
Texte dans la console
La restauration est terminée, mais le point de sauvegarde {point} n'a pas réussi la vérification en quarantaine.
Signification pour les clients de l'API
The restore finished, but the verification of the backup point in quarantine failed.
Cause. La restauration est terminée, mais la vérification demandée avec elle a échoué : une machine virtuelle distincte créée à partir du point de sauvegarde sur le réseau de quarantaine n'a pas démarré de système d'exploitation, n'a pas obtenu d'adresse ou n'a pas répondu à temps sur un port demandé. La machine virtuelle restaurée reste telle quelle.
Solution.
Lisez le résultat de la vérification dans la tâche ou dans le rapport : kyvernon backup verification report. La raison indique la preuve manquante.
Contrôlez la machine virtuelle restaurée avant de l'utiliser, ou restaurez un point de sauvegarde plus ancien.
Pour un système invité qui démarre lentement, vérifiez de nouveau avec un délai plus long.
error.backup.controller_running
Texte dans la console
Une sauvegarde de l'état du contrôleur est déjà en cours.
Signification pour les clients de l'API
A backup of the controller state is already running.
Cause. Le dossier des archives de l'état du contrôleur ne peut pas être créé, ou le service du contrôleur ne peut pas y écrire.
Solution.
Vérifiez le dossier indiqué sous controller_target dans la section [backup] de la configuration du contrôleur (par défaut : controller-backups à côté du répertoire d'état).
Donnez l'accès en écriture au service du contrôleur, ou choisissez un autre dossier et redémarrez le contrôleur.
error.backup.controller_changed
Texte dans la console
{file} a changé pendant l'archivage. Relancez la sauvegarde.
Signification pour les clients de l'API
A file of the state directory changed while it was archived.
Cause. Un fichier du répertoire d'état autre que les deux bases a changé pendant l'écriture de l'archive ; l'archive ne contiendrait pas le fichier tel qu'il a été contrôlé. Les bases sont copiées depuis une lecture cohérente et ne sont pas concernées.
Solution.
Relancez la sauvegarde : kyvernon system controller-backup --wait.
Si l'échec se répète sur le même fichier, cherchez ce qui y écrit (le fichier est nommé dans l'erreur).
error.backup.controller_unreadable
Texte dans la console
L'archive de l'état du contrôleur ne se relit pas telle qu'écrite ; elle n'a pas été conservée.
Signification pour les clients de l'API
The archive that was written does not read back as written.
Cause. Après l'écriture, le contrôleur relit chaque archive et contrôle chaque fichier avec sa somme de contrôle. Cette archive ne s'est pas relue telle qu'elle a été écrite ; elle a été supprimée et les archives plus anciennes restent. Les causes habituelles sont un disque plein ou défaillant sous le dossier des archives.
Solution.
Vérifiez l'espace libre et l'état du disque sous le dossier des archives.
Relancez la sauvegarde : kyvernon system controller-backup --wait.
error.backup.controller_unavailable
Texte dans la console
Ce contrôleur garde son état en mémoire ; il n'y a rien à archiver.
Signification pour les clients de l'API
This controller keeps its state in memory; there is nothing to archive.
Cause. Un point de sauvegarde est restauré avec la configuration de sa machine virtuelle (processeurs, mémoire, cartes réseau), et cette machine virtuelle n'existe plus.
Solution.
Créez une machine virtuelle avec la configuration voulue, puis restaurez les disques du point de sauvegarde dans celle-ci avec le logiciel de sauvegarde.
Conservez les machines virtuelles dont vous pourriez avoir besoin des sauvegardes, ou gardez un modèle de leur configuration.