So verhinderst du doppelte Filmeinträge nach dem Ändern der Speicherpfade

Eva Wong

IceWhale author

Eva Wong ist die Technische Redakteurin und und leidenschaftliche Tüftlerin bei ZimaSpace. Eine lebenslange Geek mit einer Leidenschaft für Homelabs und Open-Source-Software, sie spezialisiert sich darauf, komplexe technische Konzepte in zugängliche, praktische Anleitungenzu übersetzen. Eva ist der Meinung, dass Self-Hosting Spaß machen und nicht einschüchternd sein sollte. Durch ihre Tutorials befähigt sie die Community, Hardware-Setups zu entmystifizieren, vom Bau ihres ersten NAS bis hin zur Beherrschung von Docker-Containern.

How to Prevent Duplicate Movie Entries After Changing Storage Paths - Zima Store Online

Verhindern Sie doppelte Filme, indem Sie den alten und den neuen Pfad gegenseitig ausschließen, bevor der Medienserver die migrierte Bibliothek scannt.

Bei einer Speichermigration kann derselbe Film über zwei Bind-Mounts, zwei Bibliotheksstammverzeichnisse, eine temporäre Kopie oder einen veralteten Datenbankeintrag sichtbar werden, der nach dem Entfernen des alten Pfads bestehen bleibt. Am sichersten ist es, automatische Scans anzuhalten, die Anwendungsdatenbank zu sichern, die alten und neuen Pfade exakt zuzuordnen, Medien innerhalb eines kontrollierten Zeitfensters zu verschieben oder zu kopieren, die veraltete Quelle aus der Bibliothek zu entfernen und erst dann einen gezielten Scan auszuführen, wenn der Server nur noch einen kanonischen Speicherort sehen kann.

Ordnen Sie alle Pfade zu, über die derselbe Film erreichbar ist

Listen Sie die Bibliotheksstammverzeichnisse, Docker-Bind-Mounts, symbolischen Links, zusammengeführten Dateisysteme, Netzwerkmounts und temporären Migrationsordner auf. Ermitteln Sie für einen Film den tatsächlichen Pfad sowohl auf dem Host als auch im Container.

Doppelte Einträge entstehen häufig, weil der Scanner dieselbe Datei unter einem neuen Pfad erhält, während das alte Datenbankelement weiterhin gültig ist. Ein Jellyfin-Migrationsbericht reproduzierte das Problem, als das Verschieben von Bibliotheksordnern doppelte Einträge erzeugte.

Wählen Sie einen kanonischen Containerpfad, etwa /media/movies, und halten Sie ihn stabil, auch wenn sich die Speicherquelle auf dem Host ändert. Ein stabiler Containerpfad reduziert künftige Änderungen an der Datenbank, da die Anwendung nicht für jede Migration eines Pools oder Laufwerks einen neuen Speicherort lernen muss.

Halten Sie automatische Scans an, bevor Sie Medien kopieren oder umbenennen

Deaktivieren Sie die Echtzeitüberwachung und geplante Bibliotheksscans während der Migration. Andernfalls kann der Server unvollständige Kopien indizieren, beide Speicherorte sehen oder denselben Titel erfassen, während Ordner schrittweise umbenannt werden.

Erstellen Sie eine Sicherung der Medienserver-Konfiguration und der Datenbank, bevor Sie Pfade ändern. So bleiben Wiedergabestatus, Einstellungen für Cover, Sammlungen, Benutzer und Anbieter-IDs geschützt, die bei einem Neuaufbau der Bibliothek möglicherweise nicht exakt wiederhergestellt werden.

Kopieren oder verschieben Sie zunächst einen kleinen Testordner, überprüfen Sie Prüfsummen oder Dateigrößen und lassen Sie die alte Quelle unangetastet, bis der neue Speicherort für das Dienstkonto lesbar ist. Lassen Sie während dieses Prüfzeitraums nicht beide Pfade als aktive Bibliotheksstammverzeichnisse bestehen.

Entfernen Sie den alten Bibliothekspfad, bevor Sie den neuen scannen

Sobald der neue Pfad überprüft wurde, entfernen Sie den veralteten Ordner aus der Bibliothekskonfiguration oder ordnen Sie den bestehenden Containerpfad der neuen Hostquelle zu. Stellen Sie sicher, dass der alte Pfad nicht über eine andere Bibliothek oder einen symbolischen Link erreichbar ist.

Das Entfernen eines Pfads löscht nicht immer sofort alle zugehörigen Einträge. Ein Jellyfin-Problem berichtet, dass mit entfernten Pfaden verknüpfte Metadaten bestehen blieben. Deshalb muss die Pfadbereinigung überprüft und darf nicht einfach vorausgesetzt werden.

Führen Sie die unterstützte Bibliotheksbereinigung oder einen vollständigen Scan der Anwendung erst aus, wenn die alte Quelle nicht mehr verfügbar ist. Vermeiden Sie manuelle Datenbankänderungen, sofern Sie nicht über eine getestete Sicherung und einen versionsspezifischen Wiederherstellungsplan verfügen.

-15% OFF

ZimaBoard 2 – Mini-Heimserver für Ihre große Idee

Single board computer zimaboard2

Bewahren Sie die Medienidentität während des Verschiebens der Dateien

Behalten Sie Namen von Filmordnern, Dateinamen, Jahresangaben, Editionsbezeichnungen, Anbieter-IDs und lokalen Metadatendateien konsistent bei. Ein während derselben Migration umbenannter Titel kann als anderes Element behandelt werden, selbst wenn seine Videodaten unverändert sind.

Speichern Sie lokale Metadaten und Cover gezielt. Wenn IDs wie TMDB- oder IMDb-IDs in Namen oder NFO-Dateien eingebettet sind, bewahren Sie sie auf, damit der neue Pfad dieselbe Filmidentität und nicht eine zweite mehrdeutige Übereinstimmung erhält.

Der NAS-Datenmigrationsablauf von ZimaSpace ist der ergänzende Prüfschritt, um Quelldaten zu schützen und Berechtigungen zu überprüfen, bevor die alte Kopie entfernt wird.

Unterscheiden Sie zwei Pfade von zwei Versionen oder Editionen

Öffnen Sie beide doppelten Einträge und vergleichen Sie ihre Dateipfade, Medieninformationen, Anbieter-IDs, Laufzeit, Editions-Tags und Verfügbarkeit. Zwei Einträge können über zwei Pfade auf dieselbe Datei verweisen, zwei physische Kopien darstellen oder legitime Versionen sein, die falsch gruppiert wurden.

Veraltete Einträge können weiterhin zugänglich sein, nachdem ein Pfad verschwunden ist. Ein Jellyfin-Bericht bezeichnet diese als Phantomeinträge. Sie sollten nicht mit einer zweiten tatsächlichen Filmdatei verwechselt werden.

Wenn beide Einträge auf aktive Pfade verweisen, entfernen Sie den unbeabsichtigten Pfad aus dem Bibliotheksbereich. Wenn einer der Pfade nicht mehr existiert, verwenden Sie den unterstützten Bereinigungsprozess und überprüfen Sie, ob der Eintrag verschwindet. Wenn es sich um beabsichtigte Editionen handelt, verwenden Sie die unterstützten Benennungs- und Gruppierungsregeln des Medienservers, anstatt einen Eintrag blind zu löschen.

Muster des doppelten Eintrags	Wahrscheinliche Ursache	Richtige Maßnahme
Zwei Einträge, zwei aktive Pfade	Alte und neue Stammverzeichnisse wurden beide gescannt	Einen kanonischen Pfad beibehalten
Zwei Einträge, ein nicht mehr verfügbarer Pfad	Veralteter Datenbankeintrag	Bibliothek nach der Sicherung bereinigen
Zwei Dateien, derselbe Titel	Migrationskopie ist noch vorhanden	Überprüfen und alte Kopie aussondern
Zwei beabsichtigte Editionen	Abweichende Benennung oder Gruppierung	Unterstützte Editionsbenennung verwenden

Diese Klassifizierung verhindert, dass eine Datenbankbereinigung einen legitimen alternativen Schnitt oder eine Version höherer Qualität löscht.

Führen Sie einen kontrollierten Scan aus und überprüfen Sie den Status

Aktivieren Sie Scans erst wieder, wenn der kanonische Pfad eingebunden, der alte Pfad entfernt und der Dienstbenutzer in der Lage ist, auf den neuen Speicherort zuzugreifen. Starten Sie einen vollständigen Scan und beobachten Sie die Ereignisse zum Entfernen und Hinzufügen rund um den migrierten Film.

Bei einigen Bibliotheken wurden Dateien nach einem Speicherumzug nicht entfernt, obwohl der alte Pfad aus den Einstellungen gelöscht worden war. Ein Jellyfin-Bericht dokumentiert, dass entfernte Dateien in der Bibliothek verblieben. Daher muss die abschließende Prüfung Datenbankeinträge mit den tatsächlichen Pfaden vergleichen.

Überprüfen Sie, dass jeder Film genau einmal erscheint, über den neuen Pfad geöffnet werden kann, Wiedergabestatus und Sammlungen beibehält und einen Neustart des Dienstes übersteht. Lassen Sie den alten Speicher bis zum erfolgreichen Abschluss dieser Prüfung offline, aber intakt. Danach können Sie ihn gemäß dem Sicherungs- und Migrationsplan außer Betrieb nehmen.