Dubbele filmtitels voorkomen na het wijzigen van opslagpaden

Eva Wong is de technisch schrijver en vaste knutselaar bij ZimaSpace. Als levenslange geek met een passie voor homelabs en open-sourcesoftwareis ze gespecialiseerd in het vertalen van complexe technische concepten naar toegankelijke, praktische handleidingen. Eva vindt dat self-hosting leuk moet zijn en niet intimiderend. Met haar tutorials helpt ze de community om hardware-installaties te doorgronden, van het bouwen van hun eerste NAS tot het beheersen van Docker-containers.

Voorkom dubbele films door de oude en nieuwe paden onderling exclusief te maken voordat de mediaserver de gemigreerde bibliotheek scant.

Een opslagmigratie kan ervoor zorgen dat dezelfde film zichtbaar is via twee bindkoppelingen, twee bibliotheekroots, een tijdelijke kopie of een verouderde databaserecord die blijft bestaan nadat het oude pad is verwijderd. De veiligste werkwijze is om automatische scans stil te leggen, een back-up van de toepassingsdatabase te maken, de exacte oude en nieuwe paden in kaart te brengen, media gecontroleerd te verplaatsen of te kopiëren, de verouderde bron uit de bibliotheek te verwijderen en pas één bewuste nieuwe scan uit te voeren als de server nog maar één canonieke locatie kan zien.

Breng elk pad in kaart dat toegang geeft tot dezelfde film

Breng de bibliotheekroots, Docker-bindkoppelingen, symbolische koppelingen, samengevoegde bestandssystemen, netwerkkoppelingen en tijdelijke migratiemappen in kaart. Bepaal het werkelijke pad van één film, zowel op de host als in de container.

Dubbele vermeldingen verschijnen vaak omdat de scanner hetzelfde bestand onder een nieuw pad aantreft, terwijl het oude database-item geldig blijft. Een Jellyfin-migratierapport toonde het probleem opnieuw toen het verplaatsen van bibliotheekmappen dubbele vermeldingen veroorzaakte.

Kies één canoniek containerpad, zoals /media/movies, en houd dit stabiel, zelfs als de opslagbron op de host verandert. Een stabiel containerpad beperkt toekomstige databasewijzigingen, omdat de toepassing niet voor elke migratie naar een andere pool of schijf een nieuwe locatie hoeft te leren kennen.

Automatische scans pauzeren voordat je media kopieert of hernoemt

Schakel realtimebewaking en geplande bibliotheekscans uit tijdens de migratie. Anders kan de server gedeeltelijke kopieën indexeren, beide locaties zien of dezelfde titel registreren terwijl mappen in fasen worden hernoemd.

Maak een back-up van de configuratie en database van de mediaserver voordat je paden wijzigt. Zo blijven de kijkstatus, gekozen illustraties, collecties, gebruikers en provider-ID's behouden, die bij het opnieuw opbouwen van een lege bibliotheek mogelijk niet exact kunnen worden hersteld.

Kopieer of verplaats eerst één kleine testmap, controleer controlesommen of bestandsgroottes en laat de oude bron onaangeroerd totdat de nieuwe locatie leesbaar is voor het serviceaccount. Zorg ervoor dat beide paden tijdens deze verificatieperiode niet als actieve hoofdmappen van de bibliotheek zijn ingesteld.

Verwijder het oude bibliotheekpad voordat je het nieuwe scant

Zodra het nieuwe pad is geverifieerd, verwijder je de verouderde map uit de bibliotheekconfiguratie of koppel je het bestaande containerpad opnieuw aan de nieuwe hostbron. Controleer of het oude pad niet meer bereikbaar is via een andere bibliotheek of symbolische koppeling.

Een pad verwijderen verwijdert niet altijd meteen alle bijbehorende gegevens. Een Jellyfin-probleem meldt dat metadata die aan verwijderde paden was gekoppeld, behouden bleef. Daarom moet je padopschoning controleren in plaats van ervan uit te gaan dat die is voltooid.

Voer de ondersteunde bibliotheekopschoning of volledige scan van de toepassing pas uit nadat de oude bron niet meer beschikbaar is. Bewerk de database niet handmatig, tenzij je een geteste back-up en een herstelplan voor die specifieke versie hebt.

Single board computer zimaboard2

Behoud de media-identiteit terwijl de bestanden worden verplaatst

Houd mapnamen van films, bestandsnamen, jaartalaanduidingen, editieaanduidingen, provider-ID's en lokale metadata bestanden consistent. Een titel die tijdens dezelfde migratie wordt hernoemd, kan als een ander item worden behandeld, zelfs als de videobestanden ongewijzigd zijn.

Sla lokale metadata en illustraties bewust op. Als identificatiegegevens zoals TMDB- of IMDb-ID's in namen of NFO-bestanden zijn opgenomen, behoud ze dan zodat het nieuwe pad naar dezelfde filmentiteit verwijst en niet naar een tweede, onduidelijke overeenkomst.

De workflow voor NAS-datamigratie van ZimaSpace is de aanvullende controle om brongegevens te beschermen en machtigingen te controleren voordat de oude kopie wordt verwijderd.

Onderscheid twee paden van twee versies of edities

Open beide dubbele vermeldingen en vergelijk hun bestandspaden, media-informatie, provider-ID's, speelduur, editieaanduidingen en beschikbaarheid. Twee vermeldingen kunnen hetzelfde bestand via twee paden zijn, twee fysieke exemplaren of legitieme versies die ten onrechte zijn gegroepeerd.

Verouderde records kunnen toegankelijk blijven nadat een pad is verdwenen. Een Jellyfin-rapport noemt dit spookvermeldingen; verwar die niet met een tweede echt filmbestand.

Als beide vermeldingen naar actieve paden verwijzen, verwijder dan het ongewenste pad uit het bibliotheekbereik. Als een pad niet meer bestaat, gebruik dan het ondersteunde opschoningsproces en controleer of de vermelding verdwijnt. Als het om bewuste edities gaat, pas dan de ondersteunde naamgevings- en groeperingsregels van de mediaserver toe in plaats van er zomaar één te verwijderen.

Patroon van dubbele vermeldingen Waarschijnlijke oorzaak Juiste actie
Twee vermeldingen, twee actieve paden Oude en nieuwe hoofdlocaties worden allebei gescand Behoud één canoniek pad
Twee vermeldingen, één ongeldig pad Verouderde databaserecord Ruim de bibliotheek op na de back-up
Twee bestanden met dezelfde titel Migratiekopie is nog aanwezig Controleer en verwijder de oude kopie
Twee bewuste edities Verschil in naamgeving of groepering Gebruik ondersteunde naamgevingsconventies voor edities

Met deze classificatie voorkom je dat bij het opschonen van de database een legitieme alternatieve versie of versie van hogere kwaliteit wordt verwijderd.

Voer één gecontroleerde nieuwe scan uit en controleer de status

Schakel scannen pas weer in nadat het canonieke pad is gekoppeld, het oude pad is verwijderd en de servicegebruiker de nieuwe locatie kan lezen. Start één volledige scan en controleer op verwijderings- en toevoegingsgebeurtenissen rond de gemigreerde film.

Sommige bibliotheken zijn er niet in geslaagd bestanden te verwijderen na een opslagverplaatsing, zelfs nadat het oude pad uit de instellingen was verwijderd. Een Jellyfin-rapport documenteert verwijderde bestanden die in de bibliotheek blijven staan, dus bij de eindcontrole moeten databasevermeldingen met echte paden worden vergeleken.

Controleer of elke film één keer voorkomt, vanaf het nieuwe pad kan worden geopend, de kijkstatus en collecties behoudt en een herstart van de service overleeft. Houd de oude opslag offline maar intact totdat deze controle is geslaagd; voer deze daarna volgens het back-up- en migratieplan buiten gebruik.

Ondersteuning en tips

Meer om te lezen

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.