En säker checklista för Immich-migrering till en ny hemserver

En säker Immich-migrering börjar med att du fastställer vad som måste bevaras innan du kopierar något: fotofilerna, databasen och distributionsinställningarna som kopplar ihop dem på den nya värden.

På en hemserver uppstår migreringsrisk vanligtvis när dessa delar flyttas vid olika tidpunkter eller när destinationen startas med fel sökvägar. Betrakta den gamla servern som återställningskopian, förhindra onödiga skrivningar, dokumentera den aktuella versionen och lagringsmappningarna och flytta sedan en verifierad datamängd till den nya maskinen. Checklistan nedan håller arbetet återställningsbart tills den nya instansen kan logga in, hitta det ursprungliga biblioteket, behandla jobb och klara en omstart utan att återgå till ett tomt läge.

Frys källan och dokumentera det kända fungerande läget

Börja på den fungerande servern, inte på den nya. Dokumentera Immich-versionen, Compose- eller appbutiksdefinitionen, miljövärdena som styr databas- och lagringssökvägar, fotobibliotekets plats, databasens plats och eventuella monteringar för externa bibliotek. Notera också den aktuella serveradressen och det användarkonto du ska använda för verifiering.

Syftet med denna inventering är att förhindra att en migrering i det tysta blir en uppgradering, en ändring av sökvägar och en nätverksändring samtidigt. Håll programversionen och den logiska lagringslayouten så stabila som möjligt tills återställningen har verifierats; versionsändringar kan hanteras efter att destinationen har bekräftats.

Stoppa eller pausa nya uppladdningar före kopieringen om hushållet kan acceptera det. Om det inte är praktiskt möjligt, definiera ett övergångsfönster och planera en kort slutlig synkronisering. Du är klar med detta steg när du har en skriftlig källkarta som visar var originalfilerna finns, var databastillståndet finns och vilken konfiguration som återskapar samma relationer.

Samla databas, tillgångar och konfiguration i ett och samma migreringspaket

Hantera databasen och mediefilerna som en gemensam återställningsuppsättning i stället för två oberoende säkerhetskopior. Aktuella Immich-databassäkerhetskopior innehåller metadata och filreferenser, men inte själva fotona eller videorna. Därför måste databassäkerhetskopian flyttas tillsammans med motsvarande innehåll i UPLOAD_LOCATION och eventuella externa biblioteksdata som du hanterar separat.

Ett användbart migreringspaket behöver tillgångarna, PostgreSQL-tillståndet och konfigurationen som kopplar ihop dem. En fullständig Immich-säkerhetskopia innehåller uppladdade tillgångar, en databassäkerhetskopia som stöds och distributionskonfiguration, och återställningstest används för att bevisa att uppsättningen fungerar. Håll delarna tillsammans så att destinationen kan kopplas till en enda återställningspunkt.

Verifiera migreringspaketet innan du rör destinationen. Bekräfta att databasutdumpen inte är tom, kontrollera flera originalfiler från det kopierade biblioteket och lagra Compose- och miljöfilerna i samma migreringsmapp eller dokumentationsuppsättning. Om någon komponent inte kan verifieras ska du avbryta här och skapa en ny kopia i stället för att försöka kompensera på den nya servern.

Förbered den nya värden utan att skapa konkurrerande tillstånd

Skapa destinationskatalogerna och monteringarna först och bekräfta sedan att den nya värden ser de avsedda diskarna eller nätverksresurserna på exakt de sökvägar du planerar att använda. En saknad NAS-montering kan lämna en vanlig tom katalog efter sig, och en container kan utan problem initiera mot denna reservsökväg.

Installera körmiljön och återskapa distributionsdefinitionen, men låt inte en tom Immich-instans samla på sig uppladdningar eller konfiguration innan det gamla tillståndet har återställts. Håll autentiseringsuppgifter, databasnamn, lagringsvariabler och monteringsmål för externa bibliotek i linje med källan, såvida migreringsplanen inte uttryckligen omfattar en kontrollerad sökvägsändring.

Om den nya servern kräver andra sökvägar på värdsidan ska du mappa dem medvetet, samtidigt som du håller sökvägarna som är synliga i containern och databasens förväntningar konsekventa. Destinationen är redo först när dess faktiska monteringar pekar på de kopierade dataplaceringarna och du kan förklara varje sökvägsöversättning innan hela applikationen startas.

Featured

ZimaCube 2 personlig molnhem NAS

ZimaCube2

$799.00 - $2,499.00

Buy Now

Återställ tillståndet och återanslut alla lagringssökvägar

Återställ databasen med den återställningsmetod som gäller för den Immich-version som skapade säkerhetskopian och starta sedan de återstående tjänsterna först när databasen är redo. Improvisera inte med destruktiva databaskommandon från en äldre guide när en nyare installation använder ett annat återställningsflöde.

Under övergången ska du bevara relationen mellan databas och lagring innan normal användning återupptas. En testad Immich-migreringssekvens följer samma princip: applikationen ska öppnas mot det återställda databastillståndet och de avsedda mediesökvägarna, inte initiera ett nytt bibliotek och tvinga fram en ombyggnad från grunden.

Kontrollera lagringsåtkomsten efter starten innan du kör omfattande bakgrundsjobb. Öppna flera gamla tillgångar från olika datum, verifiera att miniatyrbilderna läses in, bekräfta ett album och en person eller ett sökresultat som fanns före migreringen och kontrollera att externa bibliotek är läsbara om du använder dem. En ny introduktionsskärm eller en tom tidslinje är en stoppsignal: kontrollera databas- och monteringsmappningarna igen innan du skriver nytt tillstånd.

Verifiera den ursprungliga arbetsbelastningen innan du avvecklar den gamla servern

En lyckad första inloggning är inte slutet på en migrering. Ladda upp ett testfoto som kan tas bort från den vanliga klienten, bekräfta att det visas i den förväntade lagringen på värden och radera det sedan via Immich. Kontrollera därefter att biblioteket fortfarande är intakt. På så sätt testar du hela skrivvägen i stället för att bara bevisa att gamla data kan läsas.

Starta om den nya hemservern och upprepa de kontroller som är viktiga för hushållet: inloggning i webbläsaren, anslutning för mobil säkerhetskopiering, flera gamla foton, sökning, en representativ video, jobbköer och fjärråtkomst om det ingår i den normala installationen. Migreringen är klar först när samma tillstånd överlever en omstart av värden och lagringsmonteringarna är tillgängliga innan Immich startar.

Håll den gamla servern avstängd men oförändrad under en återställningsperiod i stället för att radera den omedelbart. Om den nya instansen börjar skriva till en oväntad tom mapp, inte kan återskapa det gamla biblioteket efter en omstart eller visar datab abasfel som du inte kan förklara, ska du stoppa nya uppladdningar och återgå till den kända fungerande källan medan du jämför migreringspaketet. Avveckla den gamla värden först när destinationen har klarat normal användning och ett nytt säkerhetskopieringstest.