Comment éviter les doublons de films après avoir modifié les chemins de stockage
Évitez les doublons de films en rendant les anciens et les nouveaux chemins mutuellement exclusifs avant que le serveur multimédia n’analyse la bibliothèque migrée.
Une migration de stockage peut rendre le même film accessible via deux montages bind, deux racines de bibliothèque, une copie temporaire ou un ancien enregistrement de base de données qui subsiste après la suppression de l’ancien chemin. La méthode la plus sûre consiste à suspendre les analyses automatiques, sauvegarder la base de données de l’application, cartographier précisément les anciens et nouveaux chemins, déplacer ou copier les médias pendant une fenêtre contrôlée, supprimer l’ancienne source de la bibliothèque, puis lancer une seule nouvelle analyse volontaire une fois que le serveur ne peut voir qu’un emplacement canonique.
Cartographiez tous les chemins pouvant mener au même film
Répertoriez les racines de bibliothèque, les montages bind Docker, les liens symboliques, les systèmes de fichiers avec fusion, les montages réseau et les dossiers temporaires de migration. Déterminez le chemin réel d’un film depuis l’hôte et depuis le conteneur.
Les doublons apparaissent souvent parce que l’analyseur reçoit le même fichier sous un nouveau chemin alors que l’ancien élément de la base de données reste valide. Un rapport Jellyfin a reproduit le problème lorsque le déplacement de dossiers de bibliothèque a créé des doublons.
Choisissez un chemin de conteneur canonique, comme /media/movies, et gardez-le stable même si la source de stockage de l’hôte change. Un chemin de conteneur stable réduit les modifications futures de la base de données, car l’application n’a pas besoin d’apprendre un nouvel emplacement pour chaque migration de pool ou de disque.
Mettez en pause les analyses automatiques avant de copier ou de renommer les médias
Désactivez la surveillance en temps réel et les analyses planifiées de la bibliothèque pendant la migration. Sinon, le serveur risque d’indexer des copies partielles, de voir les deux emplacements ou d’enregistrer le même titre pendant que les dossiers sont renommés par étapes.
Sauvegardez la configuration et la base de données du serveur multimédia avant de modifier les chemins. Cela protège les statuts de visionnage, les choix d’illustrations, les collections, les utilisateurs et les identifiants des fournisseurs, qu’une reconstruction complète de la bibliothèque pourrait ne pas reproduire exactement.
Commencez par copier ou déplacer un petit dossier de test, vérifiez les sommes de contrôle ou la taille des fichiers et laissez l’ancienne source intacte jusqu’à ce que le nouvel emplacement soit lisible par le compte de service. Ne laissez pas les deux chemins rester des racines de bibliothèque actives pendant cette phase de vérification.
Supprimez l’ancien chemin de bibliothèque avant d’analyser le nouveau
Une fois le nouveau chemin vérifié, supprimez l’ancien dossier de la configuration de la bibliothèque ou remappez le chemin de conteneur existant vers la nouvelle source de l’hôte. Confirmez que l’ancien chemin n’est plus accessible via une autre bibliothèque ou un lien symbolique.
La suppression d’un chemin n’efface pas toujours immédiatement tous les enregistrements associés. Un problème Jellyfin signale que les métadonnées liées aux chemins supprimés ont persisté, raison pour laquelle le nettoyage des chemins doit être vérifié et non simplement supposé.
Lancez le nettoyage de bibliothèque pris en charge par l’application ou une analyse complète uniquement après que l’ancienne source est devenue inaccessible. Évitez de modifier manuellement la base de données, sauf si vous disposez d’une sauvegarde testée et d’un plan de récupération adapté à la version utilisée.
Préservez l’identité des médias pendant le déplacement des fichiers
Conservez la cohérence des noms de dossiers de films, des noms de fichiers, des indications d’année, des libellés d’édition, des identifiants de fournisseurs et des fichiers de métadonnées locaux. Un titre renommé pendant la même migration peut être considéré comme un élément différent, même si les octets de la vidéo sont inchangés.
Enregistrez volontairement les métadonnées locales et les illustrations. Si des identifiants tels que ceux de TMDB ou d’IMDb sont intégrés aux noms ou aux fichiers NFO, conservez-les afin que le nouveau chemin corresponde à la même identité de film plutôt qu’à une seconde correspondance ambiguë.
Le processus de migration de données NAS de ZimaSpace constitue la vérification complémentaire pour protéger les données sources et valider les autorisations avant de supprimer l’ancienne copie.
Faites la distinction entre deux chemins et deux versions ou éditions
Ouvrez les deux entrées en double et comparez leurs chemins de fichiers, leurs informations multimédias, leurs identifiants de fournisseurs, leur durée, leurs balises d’édition et leur disponibilité. Deux entrées peuvent correspondre au même fichier via deux chemins, à deux copies physiques ou à des versions légitimes qui ont été regroupées incorrectement.
Des enregistrements obsolètes peuvent rester accessibles après la disparition d’un chemin. Un rapport Jellyfin les appelle des entrées fantômes, qu’il ne faut pas confondre avec un second fichier de film réel.
Si les deux entrées pointent vers des chemins actifs, retirez de la bibliothèque le chemin qui n’est pas souhaité. Si l’un des chemins n’existe plus, utilisez le processus de nettoyage pris en charge et vérifiez que l’enregistrement disparaît. Si les fichiers correspondent à des éditions intentionnelles, appliquez les règles de nommage et de regroupement prises en charge par le serveur multimédia au lieu d’en supprimer une aveuglément.
| Type de doublon | Cause probable | Action correcte |
|---|---|---|
| Deux entrées, deux chemins actifs | Les anciennes et nouvelles racines ont toutes deux été analysées | Conserver un seul chemin canonique |
| Deux entrées, un chemin inexistant | Enregistrement obsolète dans la base de données | Nettoyer la bibliothèque après sauvegarde |
| Deux fichiers, même titre | La copie de migration est toujours présente | Vérifier puis retirer l’ancienne copie |
| Deux éditions intentionnelles | Incohérence de nommage ou de regroupement | Utiliser le nommage d’éditions pris en charge |
Cette classification évite qu’un nettoyage de la base de données ne supprime une autre version légitime ou une édition de meilleure qualité.
Lancez une seule nouvelle analyse contrôlée et vérifiez l’état
Réactivez l’analyse uniquement une fois le chemin canonique monté, l’ancien chemin supprimé et l’emplacement accessible en lecture par l’utilisateur du service. Lancez une analyse complète et surveillez les événements de suppression et d’ajout concernant le film migré.
Certaines bibliothèques n’ont pas supprimé les fichiers après un déplacement du stockage, même après la suppression de l’ancien chemin dans les paramètres. Un rapport Jellyfin documente des fichiers supprimés restés dans la bibliothèque ; la vérification finale doit donc comparer les entrées de la base de données aux chemins réels.
Vérifiez que chaque film apparaît une seule fois, s’ouvre depuis le nouveau chemin, conserve son statut de visionnage et ses collections, et reste disponible après le redémarrage du service. Gardez l’ancien stockage hors ligne mais intact jusqu’à la fin de cet audit ; retirez-le ensuite conformément au plan de sauvegarde et de migration.
Produits recommandés
Assistance et conseils
Plus à lire
Plex peut-il partager un GPU avec un autre conteneur Docker ?
Plex et un autre conteneur peuvent souvent accéder au même GPU, mais vous devez tester la prise en charge des pilotes, le mappage des...
Comment déterminer si une erreur Plex vient du client ou du serveur
Reproduisez le même élément sur un autre client, comparez le chemin de session, puis recueillez les preuves côté serveur uniquement après que la portée...
Comment configurer le cache de Plex et le stockage temporaire du transcodage
Protégez l’état persistant de Plex en plaçant les fichiers temporaires de transcodage sur un stockage local adapté, puis vérifiez le nettoyage, l’espace libre et...
