Solution communautaire

Échec de la migration des données de ZimaOS : vérifiez d’abord le système de fichiers

A reproducible ZimaOS user-database migration failed on an NTFS target and succeeded after the target was reformatted as EXT4.

En résumé : NTFS était la cause principale dans ce cas résolu, mais ce n’est pas une explication universelle de tous les échecs de migration

Lors du test reproductible, ZimaOS a copié les données en partie, puis a échoué parce que la cible NTFS ne pouvait pas terminer l’étape finale de copie des permissions. Le reformatage de la cible en EXT4 a permis à cette migration précise de réussir. Des réponses ultérieures ont signalé des échecs avec d’autres configurations ; « tout formater en EXT4 » doit donc être considéré comme une solution spécifique à ce cas, ainsi que comme une vérification préalable utile, et non comme un remède universel.

Écran d’erreur de migration de ZimaOS indiquant qu’un problème est survenu lors du déplacement de la base de données utilisateur vers sda1
L’écran d’échec d’origine montre l’interruption de la migration de la base de données utilisateur lors du déplacement des données de ZimaOS-HD vers sda1.

La migration actuelle doit commencer avec l’outil de migration de données pris en charge

Boîte de dialogue ZimaOS indiquant l’emplacement de stockage de la base de données utilisateur et sélectionnant sda1 comme cible de migration
Le processus de migration a sélectionné sda1 comme nouvel emplacement de stockage de la base de données utilisateur.
Boîte de dialogue de préparation de la migration de ZimaOS avertissant que les services Docker seront mis en pause pendant le déplacement
L’étape de confirmation avertit que les services Docker sont mis en pause lorsque le mode de migration est actif.
Écran de progression de la migration de la base de données utilisateur de ZimaOS à 70 %
Le transfert a atteint 70 % avant l’échec de la migration testée.

Le guide actuel de migration des données de ZimaOS déplace les images Docker, les données des applications Docker et les dossiers utilisateur par catégorie. Le guide des chemins de migration de ZimaOS est le meilleur complément actuel pour déterminer précisément ce qui est déplacé.

Vérifiez le système de fichiers cible avant de lancer la migration

lsblk -f
blkid

Vérifiez le périphérique cible, le type de système de fichiers, l’espace disponible et l’état du montage. Si la destination utilise un système de fichiers dont la gestion de la propriété et des permissions Linux diffère, la migration des données d’application risque d’être plus sensible qu’une simple copie par glisser-déposer. Le manuel de lsblk et la documentation ext4 sont des références utiles pour la validation.

Pourquoi « Arrêter Docker » apparaît-il pendant la migration ?

Ce message indique un comportement normal ; ce n’est pas l’échec en lui-même. Les données des applications ne peuvent pas être déplacées en toute sécurité si les conteneurs continuent d’y écrire. Le processus de migration met Docker en pause, copie les données gérées, met à jour l’emplacement, puis reprend le service.

Écran d’erreur de migration de ZimaOS après le déplacement de 1,08 Go vers sda1
Le test plus important s’est également terminé par le message « Un problème est survenu », après que la phase de copie a semblé s’achever.
Paramètres des applications de ZimaOS affichant les emplacements de migration des données d’application, de l’image d’application et de la base de données utilisateur
Cet écran présente les catégories de migration distinctes pour les données d’application, les images Docker et la base de données utilisateur.

Lorsque la migration échoue encore avec EXT4

Ne reformatez pas immédiatement le disque. Notez le système de fichiers source et celui de destination, l’espace libre, la catégorie de migration, la version de ZimaOS et indiquez si la cible est un disque unique ou un RAID. Reproduisez ensuite le problème avec une petite catégorie si possible. Un échec ultérieur sur un stockage créé par Zima prouve que le type de système de fichiers n’est qu’une des branches de l’arbre de décision.

Avant toute nouvelle tentative destructive, protégez vos données importantes avec le processus de sauvegarde de ZimaOS.