Immich wyświetla nieaktualne dane po zmianie ścieżki 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.

Immich Shows Stale Data After a Storage Path Change - Zima Store Online

Nieaktualne dane Immich po zmianie ścieżki magazynu mogą mieć trzy różne przyczyny, których nie należy ze sobą mieszać: przeniesienie zarządzanego katalogu głównego multimediów, zmiana ścieżki importu biblioteki zewnętrznej albo klient, który nadal wyświetla dane z pamięci podręcznej. Nowsze wydania Immich potrafią uzgodnić przeniesioną lokalizację zarządzanych multimediów, gdy skonfigurowana lokalizacja multimediów i montowanie woluminu pozostają spójne, natomiast przeniesienie biblioteki zewnętrznej nadal może zostać potraktowane jako utworzenie nowych tożsamości zasobów.

Przed ponownym skanowaniem zachowaj starą ścieżkę i bazę danych. Najpierw sprawdź, jaką ścieżkę widzi uruchomiony kontener, a następnie ustal, czy nieprawidłowy jest rekord po stronie serwera Immich, czy tylko jeden klient ma nieaktualny stan. To rozróżnienie decyduje o tym, czy należy naprawić montowanie, przywrócić stabilną ścieżkę widoczną dla kontenera, przeskanować testowy podzbiór czy wyczyścić wyłącznie pamięć podręczną klienta.

Odróżnij przeniesienie zarządzanego katalogu głównego multimediów od przeniesienia biblioteki zewnętrznej

Jeśli zmieniono lokalizację hosta dla przesyłanych plików zarządzanych przez Immich, sprawdź, czy efektywne ustawienie lokalizacji multimediów i montowanie hosta w kontenerze zostały zmienione jednocześnie. Przeniesienia zarządzanych multimediów w nowoczesnej wersji nie należy diagnozować tak samo jak zmiany nazwy ścieżki importu biblioteki zewnętrznej.

Mapa trwałego stanu Immich firmy ZimaSpace jest tutaj przydatna, ponieważ baza danych i ścieżki systemu plików tworzą jedną granicę odzyskiwania. Same właściwe pliki na hoście nie wystarczą, jeśli kontener jest zamontowany w innym miejscu.

Jeśli katalog główny zarządzanych multimediów jest niezgodny, najpierw popraw zmienne środowiskowe i mapowanie woluminów, a następnie zrestartuj usługę przed uruchomieniem zadań biblioteki. Jeśli zmieniona ścieżka należy do biblioteki zewnętrznej, zachowaj bazę danych i przetestuj tę gałąź osobno.

W miarę możliwości zachowaj stałą ścieżkę biblioteki zewnętrznej widoczną dla kontenera

W przypadku biblioteki zewnętrznej przeniesienie magazynu po stronie hosta jest najbezpieczniejsze, gdy ścieżka importu widoczna dla kontenera może pozostać bez zmian. Jeśli ścieżka prezentowana Immich ulegnie zmianie, przed skanowaniem zapisz niewielki zestaw identyfikatorów zasobów, albumów, osób i starych ścieżek, aby móc ustalić, czy istniejące zasoby zostały ponownie powiązane, czy utworzone od nowa.

Raport dotyczący zmiany ścieżki biblioteki zewnętrznej w Immich opisywał sytuację, w której przeniesione pliki były traktowane jako nowe zasoby, co prowadziło do ponownego przetwarzania i utraty relacji istniejących wyłącznie w Immich. Jest to przypadek zależny od wersji, ale potwierdza ostrożną zasadę, że zmiana ścieżki biblioteki zewnętrznej nie jest automatycznie przezroczystą zmianą nazwy.

Jeśli testowany podzbiór pojawia się jako nowe zasoby, a stare rekordy zostają oznaczone jako brakujące lub przeniesione do kosza, zatrzymaj pełne skanowanie. Jeśli to możliwe, przywróć starą ścieżkę widoczną dla kontenera albo użyj podejścia migracyjnego odpowiedniego dla danej wersji; nie przepisuj ręcznie ścieżek w produkcyjnej bazie danych bez przetestowanej kopii zapasowej.

Nie myl tej sytuacji z migracją szablonu magazynu dla plików zarządzanych przez Immich. Objaw na osi czasu może wyglądać podobnie, ale własność plików i obsługiwana ścieżka migracji są inne.

Oddziel zapisane ścieżki serwera od pamięci podręcznej klienta

Otwórz ten sam znany zasób w kliencie internetowym i innym uwierzytelnionym kliencie, a następnie porównaj wynik z logami serwera lub ścieżką widoczną dla serwera. Jeśli zadania po stronie serwera nadal wskazują starą ścieżkę, wyczyszczenie pamięci podręcznej przeglądarki nie naprawi podstawowego rekordu.

Późniejszy problem z metadanymi ze starej ścieżki w Immich pokazał, że po zmianie nazwy przetwarzanie nadal odwoływało się do poprzedniej ścieżki biblioteki zewnętrznej. Jest to mocny argument za sprawdzeniem ścieżek używanych przez zadania przed obwinieniem interfejsu mobilnego lub internetowego.

Jeśli ścieżka serwera jest prawidłowa, a nieaktualny jest tylko jeden widok internetowy, odśwież lub wyczyść pamięć podręczną tego klienta i ponownie przetestuj oryginalny plik. Buforowane miniatury i nieaktualny stan klienta mogą sprawiać, że naprawiony serwer wygląda na uszkodzony, a buforowany podgląd może również sprawiać, że uszkodzona ścieżka serwera wygląda na działającą.

-15% OFF

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

Single board computer zimaboard2

Napraw najmniejszą granicę ścieżki i sprawdź kontrolowane ponowne skanowanie

Wprowadź jedną odwracalną poprawkę: zsynchronizuj ustawienie zarządzanych multimediów z montowaniem, przywróć poprzednią ścieżkę biblioteki zewnętrznej widoczną dla kontenera, popraw ścieżkę importu albo wyczyść pamięć podręczną jednego klienta. Przed każdą czynnością, która może spowodować ponowne wykrycie dużej biblioteki, wykonaj kopię zapasową bazy danych.

Uruchom najmniejsze praktyczne ponowne skanowanie i obserwuj, czy istniejące rekordy pozostają powiązane, błędy dotyczące starej ścieżki ustają oraz nie pojawiają się zduplikowane stare i nowe zasoby. Następnie otwórz wybrane oryginały, sprawdź relacje albumów i osób, wykonaj wyszukiwanie oraz zrestartuj cały stos.

Zgłoś problem do dalszej analizy, jeśli rekordy starej i nowej ścieżki pozostają jednocześnie aktywne, duża biblioteka zewnętrzna jest nieoczekiwanie przetwarzana ponownie albo relacje znikają, mimo że oryginały nadal można odczytać. Zachowaj dokładną mapę montowań przed i po zmianie, wersję Immich, identyfikatory dotkniętych zasobów, sposób obsługi wielkości liter w systemie plików oraz znacznik czasu kopii zapasowej bazy danych.