Dubbele filminvoer voorkomen na het wijzigen van opslagpaden
Voorkom dubbele films door de oude en nieuwe paden wederzijds uit te sluiten voordat de mediaserver de gemigreerde bibliotheek scant.
Een opslagmigratie kan dezelfde film zichtbaar maken via twee bind-mounts, twee bibliotheekroots, een tijdelijke kopie of een verouderd database-record dat blijft bestaan nadat het oude pad is verwijderd. De veiligste werkwijze is om automatische scans te pauzeren, een back-up van de applicatiedatabase te maken, de exacte oude en nieuwe paden in kaart te brengen, media binnen een gecontroleerd tijdsvenster te verplaatsen of te kopiëren, de verouderde bron uit de bibliotheek te verwijderen en pas daarna één bewuste nieuwe scan uit te voeren, wanneer de server nog maar één canonieke locatie kan zien.
Breng elk pad in kaart dat toegang geeft tot dezelfde film
Noteer de bibliotheekroots, Docker-bind-mounts, symbolische koppelingen, samengestelde bestandssystemen, netwerkmounts en tijdelijke migratiemappen. Bepaal het werkelijke pad van één film vanaf zowel de host als de container.
Dubbele vermeldingen ontstaan vaak doordat de scanner hetzelfde bestand onder een nieuw pad ontvangt, terwijl het oude database-item geldig blijft. Een Jellyfin-migratierapport reproduceerde het probleem toen het verplaatsen van bibliotheekmappen dubbele vermeldingen veroorzaakte.
Kies één canoniek containerpad, zoals /media/movies, en houd dit stabiel, ook als de opslagbron op de host verandert. Een stabiel containerpad beperkt toekomstige databasewijzigingen, omdat de applicatie niet voor elke migratie van pool of schijf een nieuwe locatie hoeft te leren.
Pauzeer automatische scans voordat je media kopieert of hernoemt
Schakel realtime monitoring en geplande bibliotheekscans tijdens de migratie uit. Anders kan de server gedeeltelijke kopieën indexeren, beide locaties zien of dezelfde titel registreren terwijl mappen stapsgewijs worden hernoemd.
Maak een back-up van de configuratie en database van de mediaserver voordat je paden wijzigt. Zo blijven kijkstatussen, keuzes voor artwork, collecties, gebruikers en provider-ID's beschermd; een volledige heropbouw van de bibliotheek levert deze gegevens mogelijk niet exact opnieuw op.
Kopieer of verplaats eerst één kleine testmap, controleer controlesommen of bestandsgroottes en laat de oude bron ongemoeid totdat de nieuwe locatie leesbaar is voor het serviceaccount. Laat beide paden tijdens deze verificatie niet als actieve bibliotheekroots bestaan.
Verwijder het oude bibliotheekpad voordat je het nieuwe scant
Verwijder zodra het nieuwe pad is geverifieerd de verouderde map uit de bibliotheekconfiguratie of koppel het bestaande containerpad opnieuw aan de nieuwe bron op de host. Controleer of het oude pad niet meer via een andere bibliotheek of symbolische koppeling bereikbaar is.
Het verwijderen van een pad verwijdert niet altijd direct elk bijbehorend record. In een Jellyfin-issue staat dat metadata die aan verwijderde paden was gekoppeld bleef bestaan. Daarom moet je het opschonen van paden controleren in plaats van ervan uit te gaan dat het automatisch is gebeurd.
Voer de ondersteunde bibliotheekopschoning of volledige scan van de applicatie pas uit nadat de oude bron niet meer beschikbaar is. Bewerk de database niet handmatig, tenzij je over een geteste back-up en een hersteld plan voor de specifieke versie beschikt.
Behoud de media-identiteit terwijl de bestanden worden verplaatst
Houd namen van filmmappen, bestandsnamen, jaartalaanduidingen, editiemarkeringen, provider-ID's en lokale metadata consistent. Een titel die tijdens dezelfde migratie wordt hernoemd, kan als een ander item worden beschouwd, zelfs als de videodata ongewijzigd is.
Sla lokale metadata en artwork bewust op. Als identifiers zoals TMDB- of IMDb-ID's in namen of NFO-bestanden zijn opgenomen, behoud ze dan zodat het nieuwe pad naar dezelfde filmidentiteit verwijst in plaats van naar een tweede onduidelijke match.
De NAS-datamigratiewerkwijze van ZimaSpace is de aanvullende controle voor het beschermen van brongegevens en het controleren van machtigingen voordat de oude kopie wordt verwijderd.
Maak onderscheid tussen twee paden en twee versies of edities
Open beide dubbele vermeldingen en vergelijk hun bestandspaden, media-informatie, provider-ID's, speelduur, editiemarkeringen en beschikbaarheid. Twee vermeldingen kunnen hetzelfde bestand via twee paden zijn, twee fysieke kopieën of legitieme versies die verkeerd zijn gegroepeerd.
Verouderde records kunnen toegankelijk blijven nadat een pad is verdwenen. Een Jellyfin-rapport noemt deze spookvermeldingen. Verwar ze niet met een tweede echt filmbestand.
Als beide vermeldingen naar actieve paden verwijzen, verwijder dan het onbedoelde pad uit het bibliotheekbereik. Als één pad niet meer bestaat, gebruik je het ondersteunde opschoningsproces en controleer je of de vermelding verdwijnt. Als de bestanden opzettelijke edities zijn, pas je de ondersteunde naamgevings- en groeperingsregels van de mediaserver toe in plaats van één versie blindelings te verwijderen.
| Patroon van dubbele vermeldingen | Waarschijnlijke oorzaak | Juiste actie |
|---|---|---|
| Twee vermeldingen, twee actieve paden | Oude en nieuwe roots zijn beide gescand | Behoud één canoniek pad |
| Twee vermeldingen, één ongeldig pad | Verouderd databaserecord | Bibliotheek opschonen na back-up |
| Twee bestanden, dezelfde titel | Migratiekopie is nog aanwezig | Controleren en oude kopie buiten gebruik stellen |
| Twee opzettelijke edities | Fout in naamgeving of groepering | Ondersteunde naamgeving voor edities gebruiken |
Deze classificatie voorkomt dat het opschonen van de database een legitieme alternatieve montage of versie van hogere kwaliteit verwijdert.
Voer één gecontroleerde nieuwe scan uit en controleer de status
Schakel scans pas weer in wanneer het canonieke pad is aangekoppeld, het oude pad verdwenen is en de servicegebruiker de nieuwe locatie kan lezen. Start één volledige scan en let op gebeurtenissen rond verwijderen en toevoegen voor de gemigreerde film.
Sommige bibliotheken verwijderden bestanden niet nadat de opslag was verplaatst, zelfs niet nadat het oude pad uit de instellingen was verwijderd. Een Jellyfin-rapport documenteert dat verwijderde bestanden in de bibliotheek bleven staan. Daarom moet de eindcontrole database-items met echte paden vergelijken.
Controleer of elke film één keer verschijnt, vanaf het nieuwe pad kan worden geopend, de kijkstatus en collecties behoudt en na een herstart van de service beschikbaar blijft. Houd de oude opslag offline maar intact totdat deze controle is geslaagd; stel hem daarna buiten gebruik volgens het back-up- en migratieplan.
Aanbevolen producten
Ondersteuning & Tips
Meer om te lezen
Kan Plex een GPU delen met een andere Docker-container?
Plex en een andere container kunnen vaak dezelfde GPU gebruiken, maar je moet de driverondersteuning, apparaattoewijzing, belasting van de video-engine, het geheugengebruik en het...
Hoe je kunt bepalen of een Plex-fout door de client of de server wordt veroorzaakt
Reproduceer hetzelfde item op een andere client, vergelijk het sessiepad en verzamel pas serverbewijs nadat de scope heeft uitgewezen waar de fout daadwerkelijk zit.
Plex-cache en tijdelijke opslag voor transcodering configureren
Bescherm de permanente Plex-status door tijdelijke transcodebestanden op geschikte lokale opslag te plaatsen en controleer vervolgens het opruimen, de beschikbare ruimte en het gedrag...
