Come evitare voci duplicate per i film dopo aver cambiato i percorsi di archiviazione

Eva Wong è la redattrice tecnica e appassionata di tecnologia di ZimaSpace. Geek da sempre, appassionata di homelab e software open source, è specializzata nel tradurre concetti tecnici complessi in guide pratiche. Eva crede che l’hosting autonomo debba essere divertente, non intimidatorio. Attraverso i suoi tutorial, aiuta la community a comprendere meglio le configurazioni hardware, dalla costruzione del primo NAS alla padronanza dei container Docker.

Evita i film duplicati rendendo i percorsi vecchi e nuovi reciprocamente esclusivi prima che il server multimediale scansioni la libreria migrata.

Una migrazione dello storage può rendere accessibile lo stesso film tramite due bind mount, due radici della libreria, una copia temporanea o un record obsoleto del database che rimane dopo la rimozione del vecchio percorso. La procedura più sicura consiste nel sospendere le scansioni automatiche, eseguire il backup del database dell'applicazione, mappare con precisione i percorsi vecchi e nuovi, spostare o copiare i contenuti multimediali in un intervallo controllato, rimuovere dalla libreria la sorgente obsoleta e avviare una sola nuova scansione intenzionale, solo dopo che il server rileva un'unica posizione canonica.

Mappa ogni percorso che può raggiungere lo stesso film

Elenca le radici della libreria, i bind mount di Docker, i collegamenti simbolici, i filesystem merger, i mount di rete e le cartelle temporanee di migrazione. Individua il percorso effettivo di un film sia dall'host sia dal container.

Spesso i duplicati compaiono perché lo scanner rileva lo stesso file con un nuovo percorso, mentre il vecchio elemento del database resta valido. Un rapporto sulla migrazione di Jellyfin ha riprodotto il problema quando lo spostamento delle cartelle della libreria ha creato duplicati.

Scegli un unico percorso canonico del container, ad esempio /media/movies, e mantienilo stabile anche se cambia l'origine dello storage sull'host. Un percorso stabile del container riduce le future modifiche al database, perché l'applicazione non deve memorizzare una nuova posizione per ogni migrazione di pool o unità.

Metti in pausa le scansioni automatiche prima di copiare o rinominare i contenuti multimediali

Disattiva il monitoraggio in tempo reale e le scansioni programmate della libreria durante la migrazione. Altrimenti, il server potrebbe indicizzare copie parziali, rilevare entrambe le posizioni o registrare lo stesso titolo mentre le cartelle vengono rinominate in più fasi.

Esegui un backup della configurazione e del database del server multimediale prima di modificare i percorsi. In questo modo, durante una ricostruzione da zero della libreria, non rischi di perdere lo stato di visione, le scelte relative alle immagini, le raccolte, gli utenti e gli identificativi dei provider, che potrebbero non essere ripristinati esattamente.

Copia o sposta prima una piccola cartella di prova, verifica i checksum o le dimensioni dei file e lascia intatta la vecchia sorgente finché il servizio non riesce a leggere la nuova posizione. Durante questa fase di verifica, non lasciare che entrambi i percorsi siano attivi come radici della libreria.

Rimuovi il vecchio percorso della libreria prima di avviare la scansione di quello nuovo

Una volta verificato il nuovo percorso, rimuovi la cartella obsoleta dalla configurazione della libreria oppure rimappa il percorso esistente del container alla nuova sorgente sull’host. Verifica che il vecchio percorso non sia più raggiungibile tramite un’altra libreria o un collegamento simbolico.

La rimozione di un percorso non elimina sempre immediatamente tutti i record associati. Un problema segnalato per Jellyfin indica che i metadati collegati ai percorsi rimossi sono rimasti; per questo è necessario verificare la pulizia dei percorsi, anziché darla per scontata.

Esegui la pulizia della libreria supportata dall’applicazione o una scansione completa solo dopo che la vecchia sorgente non è più disponibile. Evita di modificare manualmente il database, a meno che tu non disponga di un backup testato e di un piano di ripristino specifico per la versione.

Mantieni l’identità dei contenuti multimediali durante lo spostamento dei file

Mantieni coerenti i nomi delle cartelle dei film, i nomi dei file, gli anni, le etichette delle edizioni, gli ID dei provider e i file di metadati locali. Se durante la stessa migrazione rinomini un titolo, potrebbe essere trattato come un elemento diverso anche se i byte del video sono invariati.

Archivia intenzionalmente i metadati locali e le illustrazioni. Se identificatori come gli ID TMDB o IMDb sono incorporati nei nomi o nei file NFO, conservali affinché il nuovo percorso rimandi alla stessa identità del film, anziché creare una seconda corrispondenza ambigua.

Il flusso di lavoro per la migrazione dei dati NAS di ZimaSpace è il controllo complementare per proteggere i dati sorgente e verificare i permessi prima di rimuovere la vecchia copia.

Distingui due percorsi da due versioni o edizioni

Apri entrambe le voci duplicate e confronta i percorsi dei file, le informazioni multimediali, gli ID dei provider, la durata, le etichette delle edizioni e la disponibilità. Due voci possono riferirsi allo stesso file tramite due percorsi, a due copie fisiche oppure a versioni legittime raggruppate per errore.

I record obsoleti possono restare accessibili anche dopo la scomparsa di un percorso. Una segnalazione di Jellyfin li definisce voci fantasma, da non confondere con un secondo file reale del film.

Se entrambe le voci puntano a percorsi validi, escludi dall’ambito della libreria il percorso indesiderato. Se uno dei percorsi non esiste più, usa la procedura di pulizia supportata e verifica che il record scompaia. Se i file sono edizioni volute, applica le regole di denominazione e raggruppamento supportate dal server multimediale, invece di eliminare alla cieca una delle due.

Schema di duplicazione Causa probabile Azione corretta
Due voci, due percorsi validi Scansionati sia il percorso precedente che quello nuovo Mantieni un solo percorso canonico
Due voci, un percorso non più valido Record obsoleto nel database Pulisci la libreria dopo il backup
Due file, stesso titolo La copia della migrazione è ancora presente Verifica ed elimina la vecchia copia
Due edizioni volute Nome o raggruppamento non corrispondente Usa la denominazione supportata per le edizioni

Questa classificazione evita che una pulizia del database elimini una versione alternativa legittima o una versione di qualità superiore.

Esegui una nuova scansione controllata e verifica lo stato

Riattiva la scansione solo dopo aver montato il percorso canonico, rimosso il vecchio percorso e verificato che l’utente del servizio possa leggere la nuova posizione. Avvia una scansione completa e controlla gli eventi di rimozione e aggiunta relativi al film migrato.

Alcune librerie non hanno rimosso i file dopo lo spostamento dei contenuti, neanche dopo aver eliminato il vecchio percorso dalle impostazioni. Una segnalazione di Jellyfin documenta la permanenza nella libreria dei file rimossi, quindi il controllo finale deve confrontare le voci del database con i percorsi reali.

Verifica che ogni film compaia una sola volta, si apra dal nuovo percorso, mantenga lo stato di visione e le raccolte e rimanga disponibile dopo il riavvio del servizio. Mantieni offline il vecchio archivio, senza modificarlo, finché questa verifica non è superata; poi dismettilo secondo il piano di backup e migrazione.

Assistenza e consigli

Altre letture

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.