Guide de dépannage¶

Les sauvegardes ne fonctionnent plus (Backup ECHEC)¶

Note : toute sauvegarde non effectuée après 40h par rapport à la dernière sauvegarde déclanche l’envoi d’un mail type « Backup ECHEC ».

La sauvegarde ne se lance pas du tout¶

Toutes plateformes¶

L’appareil est éteint ou en veille
L’appareil n’est pas connecté à Internet
Le port 4443 bloqué et le client de sauvegarde ne peut pas contacter le pool de sauvegarde
- Ouvertures de flux à réaliser :
  - Cloud : https://pool4.kiwi-backup.com:4443/
  - Santé : https://pool.sante.kiwi-backup.com:4443/
  - URL personnalisé, cas spécifique
Problème avec le fichier kiwi.conf
- Note : le fichier kiwi.conf est au format YAML (attention à l’indentation !)
- Le fichier kiwi.conf est supprimé ou modifié
- Le tout premier jeu de sauvegarde avec l’ID backup1 n’est plus présent
- L’ID de sauvegarde contient des espaces
Plantage pour une raison inconnue du client de sauvegarde au lancement

Windows¶

L’état d’alimentation remonté par le système d’exploitation indique que l’ordinateur fonctionne sur batterie (les tâches de sauvegardes et mise à jour ne fonctionne que si l’ordinateur est branché au secteur)
- Ordinateur portable : brancher le bloc d’alimentation
- Serveur/ordinateur avec onduleur : vérifier la bonne remonté de l’état d’alimentation de l’onduleur et vérifier qu’il indique bien que l’ordinateur est branché au secteur.
Les tâches planifiées sont absentes ou en dommagées
- Info : les tâches planifiées pour la sauvegarde porte le nom du jeu de sauvegarde : backup1, xxxx suivant le nom qui est donné
- Cause : les tâches planifiées n’ont pu être inscrite pour une raison ou une autre :
  - Intervention humaine sur les tâches planifiées
  - Échec de l’exécution schtasks.exe : blocage de l’exécution par un logiciel de sécurité ou variable d’environnement %PATH% altéré, ne contient pas/plus %SystemRoot%\system32
- Solution : réinscrire les tâches de sauvegardes :
  - Ouvrir une invite de commande en Administrateur
  - Se positionner dans le dossier du client : CD /D C:\\Program Files\\Kiwi-Backup\\Kiwi-Backup ; adaptez le chemin en fonction de votre client installé : Santé, Kit…
  - Lancer : START /WAIT kiwi.exe schedulebackups --all -v
  - Si vous avez une erreur exec: "schtasks.exe": executable file not found in %PATH%, alors vérifiez et corrigez la variable d’environnement PATH dans Windows. Doit contenir %SystemRoot%\system32
Problème avec kiwi.exe
- kiwi.exe est bloqué : la solution de sécurité ou le système d’exploitation bloque l’accès à kiwi.exe
- kiwi.exe est absent : il a pu être supprimé ou mis en quarantaine par une solution de sécurité
- Si kiwi.exe.old est présent mais que kiwi.exe est absent
  - Cause : cela PEUT être un incident survenu pendant la mise à jour automatique du produit
  - Solution 1 : renommer kiwi.exe.old en kiwi.exe pour restaurer le fonctionnent du produit
  - Solution 2 : réinstaller le produit dans sa dernière version
Cas beaucoup plus rare, interférance avec une version antérieur du produit (kiwi v3)
- Arrêter les services KCron et KClient
- Tuer les processus restant : kiwi.exe et Kiwi-Backup.exe
- Désinstaller l’ancienne version : C:\\Program Files\\Kiwibackup2\\uninst-kiwi2.exe. Le chemin peut changer si vous utilisez un Kit en marque blanche.
- Désinstaller le client de sauvegarde
- Réinstaller le client de sauvegarde dans sa dernière version

MacOs¶

Le moteur de planification, kiwi runCron, n’est pas/plus en cours d’exécution
Cas beaucoup plus rare, interférance avec une version antérieur du produit 4.0, 4.1, 4.2 …
- Tuer l’ensemble des processus portant le nom kiwi
- Déinstaller les clients de sauvegardes
- Supprimer les fichiers :
  - /Library/LaunchAgents/com.kiwi-backup.backup1.plist Remplacez backup1 par les ID des autres jeu de sauvegade configuré, si c’est le cas.
  - /Library/LaunchAgents/com.kiwi-backup.update.plist
  - /Library/LaunchDaemons/com.kiwi-backup.httpgui.plist
- Réinstaller le client de sauvegarde dans sa dernière version

Linux¶

La tâche CRON est absente
- Cause 1 : la tâche cron n’est pas créé/modifié automatiquement sous Linux (comportement nominal)
- Cause 2 : la tâche cron a été supprimé
- Solution : depuis un terminal en super-utilisateur, lancer la commande kiwi4 schedulebackups --all
- Info : la tâche cron est enregistré dans le fichier /etc/cron.d/backup1, /etc/cron.d/<backup id> …

Synology, QNAP¶

Cause : le moteur de planification, kiwi runCron, n’est pas/plus en cours d’exécution
Solution : relancer le paquet depuis le centre logiciel

La sauvegarde s’interrompt pendant son exécution¶

Toutes plateformes¶

Perte de la connexion Internet
Arrêt de l’appareil
Mise en veille de l’appareil
Plus d’espace disque disponible
Plantage pour une raison inconnue du client de sauvegarde pendant la sauvegarde

Synology (spécifiquement)¶

NAS ayant réalisé une migration de DSM 6 vers DSM 7, et dont le client de sauvegade était présent en DSM 6
Les droits doivent être corrigés sur les emplacements du client de sauvegarde pour fonctionner correctement avec DSM 7
Ouvrir un terminal en super-utilisateur puis saisissez les commandes suivante :

chown -R KiwiBackup:KiwiBackup /var/packages/KiwiBackup/etc/
chown -R KiwiBackup:KiwiBackup /var/packages/KiwiBackup/home/
chown -R KiwiBackup:KiwiBackup /var/packages/KiwiBackup/share/
chown -R KiwiBackup:KiwiBackup /var/packages/KiwiBackup/target/
chown -R KiwiBackup:KiwiBackup /var/packages/KiwiBackup/tmp/
chown -R KiwiBackup:KiwiBackup /var/packages/KiwiBackup/var/

Relancer le paquet Kiwi-Backup depuis le centre logiciel

La sauvegarde s’est effectué avec des erreurs (Backup ERREUR)¶

Si la sauvegarde arrive à son terme, mais que des erreurs d’accès sur des fichiers sont rencontrés, cela génère un rapport « Backup ERREUR » avec la liste des fichiers concernés.

Toutes plateformes¶

Droit d’accès (Système de fichier : ACL)
Blocage par une solution de sécurité
Fichiers en cours d’utilisation/vérrouillés
Volumes/partitions non monté
Dossier racine en liste d’inclusion supprimé, déplacé ou renommé

Windows¶

Fichiers en cours d’utilisation/vérrouillés -> activer le VSS
Fichiers chiffrés (NTFS:EFS)
Disque réseau non monté
Disque externe non branché ou ayant reçu une autre lettre de lecteur que celle habituellement utilisé

Cas spécifique : Backup ERREUR avec 0 alertes¶

L’appareil exécute une version du produit qui n’est plus supporté -> mettre à jour le produit
Problème transitoire où les remontés de journaux et progression ne fonctionne pas

Lenteur de la sauvegarde¶

Internet avec une vitesse d’envoi insufisante ou connexion saturée (type de connexion WAN déconseillé : RTC(56k), RNIS, DSL, câble coaxial, 2G/3G, …)
Connexion entre l’appareil et le routeur de faible vitesse et/ou éloigné (Lan 10/100Mb, Wi-Fi, Li-Fi, Bluetooth, …)
Très grande quantité de petits fichiers
Très grande quantité de données
Mise en veille de l’appareil
Lenteur des accès disques et/ou réseaux causés par les logiciels de sécurités
Changement d’algorithme dans le traitement des données qui implique le réenvoit de blocs de données (migration d’une version 4.0, 4.1, 4.2 ou 4.3 vers la version 4.4 par exemple)
Saturation des ressources (processeur/mémoire/disque) sur l’appareil

Le produit n’est pas à jour et ne se met pas à jour¶

Windows, MacOs, QNAP¶

La machine est éteinte ou en veille
L’accès au serveur de mise à jour est bloqué
- Ouvertures de flux à réaliser : https://upd4.sauvegardes.org:443/
Le produit est dans une version antérieur 4.0, 4.1, 4.2 ou 4.3 -> le produit doit être mis à jour manuellement
La mise à jour automatique pour MacOS est implémenté à partir de la version 4.4.68
La mise à jour automatique pour QNAP est implémenté à partir de la version 4.4.102

Windows (spécifiquement)¶

L’état d’alimentation remonté par le système d’exploitation indique que l’ordinateur fonctionne sur batterie (les tâches de sauvegardes et mise à jour ne fonctionne que si l’ordinateur est branché au secteur)
- Ordinateur portable : brancher le bloc d’alimentation
- Serveur/ordinateur avec onduleur : vérifier la bonne remonté de l’état d’alimentation de l’onduleur et vérifier qu’il indique bien que l’ordinateur est branché au secteur.
La tâche planifiée de mise à jour est absente ou en dommagée
- Info : la tâche planifiée pour la pour la mise à jour porte le nom k_update
- Cause : la tâche planifiée n’a pu être inscrite pour une raison ou une autre :
  - Intervention humaine sur les tâches planifiées
  - Échec de l’exécution schtasks.exe : blocage de l’exécution par un logiciel de sécurité ou variable d’environnement %PATH% altéré, ne contient pas/plus %SystemRoot%\system32
- Solution : réinscrire la tâche de mise à jour :
  - Ouvrir une invite de commande en Administrateur
  - Se positionner dans le dossier du client : CD /D C:\\Program Files\\Kiwi-Backup\\Kiwi-Backup ; adaptez le chemin en fonction de votre client installé : Santé, Kit…
  - Lancer : START /WAIT kiwi.exe scheduleupdate -v
  - Si vous avez une erreur exec: "schtasks.exe": executable file not found in %PATH%, alors vérifiez et corrigez la variable d’environnement PATH dans Windows. Doit contenir %SystemRoot%\system32
Problème avec kiwi.exe
- kiwi.exe est bloqué : la solution de sécurité ou le système d’exploitation bloque l’accès à kiwi.exe
- kiwi.exe est absent : il a pu être supprimé ou mis en quarantaine par une solution de sécurité
- Si kiwi.exe.old est présent mais que kiwi.exe est absent
  - Cause : cela PEUT être un incident survenu pendant la mise à jour automatique du produit
  - Solution 1 : renommer kiwi.exe.old en kiwi.exe pour restaurer le fonctionnent du produit
  - Solution 2 : réinstaller le produit dans sa dernière version
L’ASLR est activé : le package d’installation n’est pas actuellement pas compatible avec l’ASLR (randomisation du format d’espace d’adresse). Le lancement du package résulte avec une erreur de lancement 0xc000007b. L’option correspondante dans la sécurité de Windows est : « Forcer la randomisation des images (randomisation du format d’espace d’adresse obligatoire) – Force le réadressage des images non compilées avec /DYNAMICBASE ». Pour installer ou mettre à jour le client de sauvegade, ce mécanisme doit être désactivé. Ce mécanisme n’a pas d’influence sur le fonctionnement de la sauvegarde une fois le logiciel installé.
Mise à jour manuelle du produit, en ligne de commande
- Fermer toutes les fenêtres du client de sauvegade, si des sauvegardes sont en cours, attendre qu’elles finissent ou bien les arrêter.
- Ouvrir une invite de commande en Administrateur
- Se positionner dans le dossier du client : CD /D C:\\Program Files\\Kiwi-Backup\\Kiwi-Backup ; adaptez le chemin en fonction de votre client installé : Santé, Kit…
- Lancer : START /WAIT kiwi.exe update -v

Synology¶

L’installation et la mise à jour se fait via dépôt logiciel : https://syno.kiwi-backup.com/
La mise à jour doit être effectué par l’administrateur du NAS, ou bien peut activer les mises à jour automatique dans le centre logiciel

Linux¶

L’installation et la mise à jour se fait via dépôt logiciel : https://apt.kiwi-backup.com/
La mise à jour doit être effectué par l’administrateur de la machine Linux (via apt-get update puis apt-get upgrade). Pas de mise à jour automatique du produit possible.

Pas d’interface graphique quand on lance le client de sauvegarde¶

Windows¶

Le composant Microsoft WebView2 n’est pas installé. Si le client de sauvegarde ne le détecte pas, il propose de l’installer. Si vous avez besoin d’effectuer une installation hors ligne (restriction d’accès à Internet), vous pouvez télécharger un installateur hors ligne à cet adresse : https://developer.microsoft.com/fr-fr/microsoft-edge/webview2?form=MA13LH#download . Prendre : Installateur autonome Evergreen pour x64. Si vous utilisez un ancien système d’exploitation Windows 7, 8 ou 8.1, ainsi que Server 2008r2, Server 2012 et Server 2012r2, contacter le support pour obtenir un paquage d’installation hors ligne, la version proposé sur le site de Microsoft n’est plus compatible.
Si écran blanc ou message d’erreur
- Tenter de réinstaller le produit
- Vérifier aussi qu’il n’y a pas une version antérieur du produit qui est installé

MacOS¶

Si écran blanc ou message d’erreur
- Ancienne version du produit -> mettre à jour le produit
- Tenter de réinstaller le produit
- Vérifier aussi qu’il n’y a pas une version antérieur du produit qui est installé

Synology, QNAP¶

Cause : le moteur de GUI, kiwi runHttp, n’est pas/plus en cours d’exécution
Solution : relancer le paquet depuis le centre logiciel
Remarque : le produit n’est pas compatible avec QuickConnect. De ce fait la sauvegarde ne peut être administé qu’à travers le réseau local
Remarque : n’exposez pas l’administration du client sur Internet pour un accès distant. Preférez l’usage d’un VPN pour cela ou d’une solution de cybersécurité adapté.

Linux¶

Remarque : le produit ne dispose pas d’une GUI intégré comparé à Windows et MacOS. Nous sommes dans le même cas de figure que Synology et QNAP au détail près que le composant runHttp n’est pas lancé. Si vous avez besoin d’avoir accès une GUI vous pouvez lancer kiwi runHttp pour une administration local, ou bien kiwi runHttp --listen :8183 pour une administration à travers le réseau local. Ensuite ouvrir un navigateur Web puis saisir : http://<hostname>:8183/. Remplacez bien entendu <hostname> en fonction de votre cas de figure.
Remarque : n’exposez pas l’administration du client sur Internet pour un accès distant. Preférez l’usage d’un VPN pour cela ou d’une solution de cybersécurité adapté.

Archive de restauration .tar.gz¶

Les logiciels de compression (7-Zip, IzArc, …) peuvent rencontrer des difficultés à lire l’archive de restauration au format .tar.gz ou bien n’en voit qu’une partie
- Solution : utiliser GNU TAR ou BSDTAR (libarchive) utilisable en ligne de commande. Pour les utilisateurs de Windows, (tar.exe)[https://ss64.com/nt/tar.html] est inclus dans le système d’exploitation à partir de Windows 10 verison 1803 et Windows Server 2019. Pour les autres versions de Windows, il vous faudra trouver un portage de GNU TAR ou BSD TAR correspondant.