Jak zapobiegać duplikowaniu pozycji filmów po zmianie ścieżek przechowywania

Eva Wong

IceWhale author

Eva Wong jest Technicznym pisarzem i stałym majsterkowiczem w ZimaSpace. Całe życie geek z pasją do homelabów i oprogramowania open-source, specjalizuje się w tłumaczeniu skomplikowanych koncepcji technicznych na przystępne, praktyczne przewodniki. Eva wierzy, że samodzielne hostowanie powinno być zabawą, a nie czymś onieśmielającym. Poprzez swoje samouczki umożliwia społeczności rozwiewanie tajemnic konfiguracji sprzętu, od budowy pierwszego NAS po opanowanie kontenerów Docker.

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

Zapobiegaj duplikowaniu filmów, sprawiając, aby stare i nowe ścieżki wzajemnie się wykluczały, zanim serwer multimediów przeskanuje zmigrowaną bibliotekę.

Migracja pamięci masowej może ujawnić ten sam film za pośrednictwem dwóch montowań bind, dwóch katalogów głównych biblioteki, tymczasowej kopii lub nieaktualnego rekordu bazy danych, który pozostał po usunięciu starej ścieżki. Najbezpieczniejszy przebieg prac obejmuje wstrzymanie automatycznych skanów, wykonanie kopii zapasowej bazy danych aplikacji, wskazanie dokładnych starych i nowych ścieżek, przeniesienie lub skopiowanie multimediów w kontrolowanym oknie, usunięcie nieaktualnego źródła z biblioteki oraz uruchomienie jednego celowego ponownego skanowania dopiero wtedy, gdy serwer widzi jedną kanoniczną lokalizację.

Ustal każdą ścieżkę, która może prowadzić do tego samego filmu

Wymień katalogi główne biblioteki, montowania bind Dockera, dowiązania symboliczne, systemy plików typu merger, montowania sieciowe i tymczasowe foldery migracyjne. Ustal rzeczywistą ścieżkę jednego filmu zarówno z poziomu hosta, jak i kontenera.

Duplikaty często pojawiają się, ponieważ skaner otrzymuje ten sam plik pod nową ścieżką, podczas gdy stary element w bazie danych nadal jest prawidłowy. Raport dotyczący migracji Jellyfin odtworzył ten problem, gdy przenoszenie folderów biblioteki utworzyło duplikaty.

Wybierz jedną kanoniczną ścieżkę kontenera, na przykład /media/movies, i zachowaj ją bez zmian, nawet jeśli zmieni się źródło pamięci masowej hosta. Stabilna ścieżka kontenera ogranicza przyszłe zmiany w bazie danych, ponieważ aplikacja nie musi uczyć się nowej lokalizacji przy każdej migracji puli lub dysku.

Wstrzymaj automatyczne skany przed kopiowaniem lub zmianą nazw multimediów

Wyłącz monitorowanie w czasie rzeczywistym i zaplanowane skany biblioteki na czas migracji. W przeciwnym razie serwer może zindeksować niepełne kopie, zobaczyć obie lokalizacje lub zarejestrować ten sam tytuł podczas etapowej zmiany nazw folderów.

Przed zmianą ścieżek wykonaj kopię zapasową konfiguracji i bazy danych serwera multimediów. Chroni to informacje o obejrzanych materiałach, wyborze okładek, kolekcjach, użytkownikach i identyfikatorach dostawców, których dokładne odtworzenie podczas tworzenia czystej biblioteki może nie być możliwe.

Najpierw skopiuj lub przenieś jeden mały folder testowy, sprawdź sumy kontrolne lub rozmiary plików i pozostaw stare źródło nietknięte do czasu, aż nowa lokalizacja będzie dostępna dla konta usługi. W tym oknie weryfikacji nie zezwalaj, aby obie ścieżki pozostawały aktywnymi katalogami głównymi biblioteki.

Usuń starą ścieżkę biblioteki przed skanowaniem nowej

Po zweryfikowaniu nowej ścieżki usuń nieaktualny folder z konfiguracji biblioteki albo zmień mapowanie istniejącej ścieżki kontenera na nowe źródło hosta. Upewnij się, że stara ścieżka nie jest już dostępna za pośrednictwem innej biblioteki ani dowiązania symbolicznego.

Usunięcie ścieżki nie zawsze natychmiast usuwa wszystkie powiązane rekordy. Zgłoszenie dotyczące Jellyfin informuje, że metadane powiązane z usuniętymi ścieżkami pozostały, dlatego usunięcie ścieżki należy zweryfikować, a nie zakładać, że zakończyło się powodzeniem.

Uruchom obsługiwane przez aplikację czyszczenie biblioteki lub pełne skanowanie dopiero wtedy, gdy stare źródło będzie niedostępne. Unikaj ręcznej edycji bazy danych, chyba że masz sprawdzoną kopię zapasową i plan odzyskiwania dostosowany do konkretnej wersji.

-15% OFF

ZimaBoard 2 – Mini serwer domowy dla Twojego wielkiego pomysłu

Single board computer zimaboard2

Zachowaj tożsamość multimediów podczas przenoszenia plików

Zachowaj spójność nazw folderów filmów, nazw plików, oznaczeń roku, etykiet wydań, identyfikatorów dostawców i lokalnych plików metadanych. Film, którego nazwę zmieniono podczas tej samej migracji, może zostać potraktowany jako inny element, nawet jeśli jego dane wideo pozostały niezmienione.

Świadomie przechowuj lokalne metadane i okładki. Jeśli identyfikatory, takie jak TMDB lub IMDb, są zawarte w nazwach lub plikach NFO, zachowaj je, aby nowa ścieżka wskazywała tę samą tożsamość filmu, a nie drugi niejednoznaczny wynik.

Proces migracji danych NAS w ZimaSpace to dodatkowa kontrola dotycząca ochrony danych źródłowych i weryfikacji uprawnień przed usunięciem starej kopii.

Odróżnij dwie ścieżki od dwóch wersji lub wydań

Otwórz oba zduplikowane wpisy i porównaj ich ścieżki plików, informacje o multimediach, identyfikatory dostawców, czas trwania, etykiety wydań i dostępność. Dwa wpisy mogą wskazywać ten sam plik za pośrednictwem dwóch ścieżek, dwie fizyczne kopie albo prawidłowe wersje, które zostały niepoprawnie zgrupowane.

Nieaktualne rekordy mogą pozostać dostępne po zniknięciu ścieżki. Raport dotyczący Jellyfin określa je jako pozorne wpisy, których nie należy mylić z drugim rzeczywistym plikiem filmu.

Jeśli oba wpisy wskazują aktywne ścieżki, usuń niezamierzoną ścieżkę z zakresu biblioteki. Jeśli jedna ścieżka już nie istnieje, użyj obsługiwanego procesu czyszczenia i sprawdź, czy rekord zniknie. Jeśli pliki są zamierzonymi wydaniami, zastosuj obsługiwane przez serwer multimediów zasady nazewnictwa i grupowania zamiast bezmyślnie usuwać jeden z nich.

Wzorzec duplikatu	Prawdopodobna przyczyna	Prawidłowe działanie
Dwa wpisy, dwie aktywne ścieżki	Przeskanowano stare i nowe katalogi główne	Pozostaw jedną kanoniczną ścieżkę
Dwa wpisy, jedna nieaktywna ścieżka	Nieaktualny rekord bazy danych	Wyczyść bibliotekę po wykonaniu kopii zapasowej
Dwa pliki, ten sam tytuł	Kopia migracyjna nadal istnieje	Zweryfikuj i wycofaj starą kopię
Dwa zamierzone wydania	Niezgodność nazewnictwa lub grupowania	Użyj obsługiwanego nazewnictwa wydań

Ta klasyfikacja zapobiega sytuacji, w której czyszczenie bazy danych usuwa prawidłową alternatywną wersję lub wydanie o wyższej jakości.

Uruchom jedno kontrolowane ponowne skanowanie i zweryfikuj stan

Ponownie włącz skanowanie dopiero wtedy, gdy zamontowano kanoniczną ścieżkę, stara ścieżka została usunięta, a użytkownik usługi może odczytywać nową lokalizację. Uruchom jedno pełne skanowanie i obserwuj zdarzenia usuwania oraz dodawania dotyczące przeniesionego filmu.

W niektórych bibliotekach po przeniesieniu pamięci masowej nie udawało się usunąć plików, nawet po usunięciu starej ścieżki z ustawień. Raport dotyczący Jellyfin dokumentuje pozostawanie usuniętych plików w bibliotece, dlatego końcowa kontrola musi porównać wpisy w bazie danych z rzeczywistymi ścieżkami.

Sprawdź, czy każdy film pojawia się tylko raz, otwiera się z nowej ścieżki, zachowuje status obejrzenia i kolekcje oraz pozostaje dostępny po ponownym uruchomieniu usługi. Do czasu pomyślnego zakończenia tego audytu pozostaw starą pamięć masową odłączoną od sieci, ale nienaruszoną; następnie wycofaj ją zgodnie z planem tworzenia kopii zapasowych i migracji.