Een nieuwe Jellyfin-server valideren voordat je productiedata migreert
Valideer de nieuwe Jellyfin-server eerst met gekopieerde status en wegwerpmedia; pas nadat weergave, herstel en terugrollen zijn geslaagd, verplaats je productiegegevens.
Behandel migratie als één gecontroleerd traject, waarbij de oude server gezaghebbend blijft. Herstel een versiegebonden controlepunt naar een geïsoleerd doelsysteem, reproduceer de logische koppelingen en runtime-identiteit en test vervolgens de clients, codecs, ondertitels, externe route, scanners en herstartgedrag die er echt toe doen. Een dashboard dat opent, is slechts het eerste controlepunt; de zwakste mislukte afhankelijkheid bepaalt de uitkomst.
Bevries de productie-basislijn en de terugrollijn
Leg de Jellyfin-versie van de bron vast, de installatiemethode, de runtime-UID/GID of het serviceaccount, de configuratie- en cachelocaties, de logische mediapaden, de koppelingen van hardwareapparaten, het adres van de reverseproxy, certificaten, gebruikers, het aantal bibliotheken, geplande taken, plug-ins en één voorbeeld van bewezen goede weergave voor elk essentieel pad.
Bepaal wat als mislukking geldt voordat je het doelsysteem aanraakt: een fout bij databasemigratie, een ontbrekende bibliotheek, verkeerd eigenaarschap, een mislukte aanmelding, ontbrekende hardwareversnelling, een essentiële client die niet werkt of een terugrol die langer duurt dan de toegestane storing. Zo wordt migratie een reeks controleerbare criteria in plaats van een vage controle op basis van vertrouwen.
Maak een samenhangend controlepunt en laat de bron ongewijzigd na de testbasislijn. Een recent rapport over een mislukte migratie laat zien waarom het koppelen van applicatieversies bij de basislijn hoort: herstel kan mislukken bij de databasemigratie, zelfs als de bestanden aanwezig zijn.Bouw een stagingpad dat alleen kopieën gebruikt
Installeer het doelsysteem met dezelfde Jellyfin-versie als het controlepunt en herstel het daarna naar geïsoleerde opslag. Kopieer representatieve media of koppel een kleine testsubset alleen-lezen. Hernoem, verwijder of herorganiseer geen productiebestanden om de kandidaat werkend te krijgen; elke destructieve wijziging verwijdert bewijs waarmee je kunt terugrollen.
Geef het doel een tijdelijke hostnaam, een tijdelijk adres en een tijdelijk client-eindpunt. Voorkom dat geplande taken, webhooks, downloaders of automatisering beide instanties als actief behandelen. Twee servers mogen hetzelfde onveranderlijke voorbeeld lezen, maar mogen niet dezelfde database, cache, metadataboom of invoerlocatie beschrijven.
Als het platform zelf verandert, reproduceer dan één grens tegelijk: containerpad, service-identiteit, opslagprotocol, netwerkroute en daarna toegang tot de accelerator. De herstelbare containerimplementatie biedt een uitgebreidere aanpak voor het declareren van koppelingen en persistente status.Duidelijke identiteit-, pad- en versiecriteria
Start de kandidaat op en inspecteer de logs voordat je het dashboard opent. Controleer of de herstelde serveridentiteit is geladen en niet de configuratie voor de eerste keer is gestart, of alle verwachte mediapaden zijn gekoppeld en of de runtime media kan lezen en alleen naar de bedoelde status- en cachepaden kan schrijven.
Herstart het volledige doelsysteem, niet alleen de applicatie. Controleer na een koude start de volgorde van afhankelijkheden, opslagmounts, DNS, proxyrouting, certificaten, geplande taken, plug-ins en toegang tot GPU-apparaten. Een geslaagde interactieve start kan een fout in de opstartvolgorde of rechten verbergen.
Stop bij elke waarschuwing over databasemigratie, lege bibliotheek door een ontbrekende mount, mismatch van eigenaar, padwijziging of terugval naar softwaretranscodering terwijl hardwareversnelling vereist was. Gebruik de checklist voor identiteit en status om de herstelde instantie te vergelijken met de bekende, goed werkende bron.
Voer een representatieve werklastmatrix uit
Testresultaten, geen menu's. Gebruik hetzelfde bestand, dezelfde client, hetzelfde ondertitelspoor, dezelfde uitvoerresolutie en dezelfde netwerkroute als bij de nulmeting. Bekijk tijdens elke test het Jellyfin-dashboard en de transcodeerlogboeken en noteer de starttijd, buffering, overgeslagen frames, CPU/GPU-gebruik en of de modus Direct afspelen, remuxen of transcoderen was.
| Pad | Representatieve test | Voorwaarde voor geslaagd |
|---|---|---|
| Lokaal direct afspelen | Bekende compatibele client en bestand | Direct afspelen, stabiel zoeken, geen nieuwe fouten |
| Ondertiteling | Veelgebruikte tekstondertiteling en de lastigste afbeeldings- of opgemaakte ondertiteling | Correcte weergave en realtime afspelen |
| HDR/transcodering | Vereiste conversie met de hoogste belasting | Verwachte versneller gebruikt, snelheid hoger dan realtime |
| Gelijktijdigheid | Realistische gelijktijdige sessies | Geen overbelasting of tekorten |
| Bibliotheek | Incrementele scan en metadatalezing | Geen dubbele paden of verloren aangepaste gegevens |
| Extern | Externe client via de gebruikelijke route | Authenticatie, certificaat, bitrate en afspelen werken |
Een geslaagd eenvoudig bestand kan niet in de plaats komen van de lastigste verplichte controle. Als een kritieke client- of ondertitelroute niet werkt, herstel dan die afhankelijkheid en voer de matrix opnieuw uit, of verwijder deze expliciet uit de productievereisten voordat je overschakelt.
Bewijs dat herstel werkt, en schakel dan in één keer over
Maak een nieuw controlepunt van het doel, vernietig alleen de tijdelijke doelstatus en herstel deze schoon. Herhaal de controles voor aanmelding, bibliotheek, afspelen, herstarten en geplande taken. De onafhankelijke handleiding voor herstel vóór de upgrade benadrukt de praktische grens: een back-up verdient pas vertrouwen als die een herstel en herstart doorstaat.Plan één omschakelmoment. Pauzeer wijzigingen aan de bron, maak een laatste statuscontrolepunt, synchroniseer de geplande mediawijzigingen, herstel of werk het doel bij en wijzig daarna het enige eindpunt dat clients gebruiken. Voer de blokkerende controles opnieuw uit voordat je normale schrijfbewerkingen of bibliotheekonderhoud toestaat.
Houd de oude server tijdens de observatieperiode uitgeschakeld of geïsoleerd, maar intact. Zet terug door het oorspronkelijke eindpunt te herstellen, niet door een onzekere doelstatus terug te kopiëren. Schakel de bron pas uit nadat de nieuwe server normaal belast is, een geplande herstart heeft doorstaan, een back-upcyclus heeft voltooid en de afgesproken herstelperiode is verstreken.
Aanbevolen producten
NAS- en serverconfiguratie
Meer om te lezen
Kan een server in een studentenkamer stil genoeg werken om te slapen, studeren en videogesprekken te voeren?
Ja, een server in een studentenkamer kan onopvallend blijven als de hardware energiezuinig is, trillingen van de opslag worden beperkt, zware taken worden ingepland...
Een studentenhomelab dat meeverhuist van de studentenkamer naar het eerste appartement
Houd een studentenhomelab draagbaar door services los te koppelen van de netwerkinfrastructuur in specifieke kamers, de hardware tot een minimum te beperken, een back-up...
Eén homeserver delen met huisgenoten zonder accounts of privébestanden te delen
Geef elke huisgenoot een eigen account, privéopslag en alleen de gedeelde rollen die nodig zijn; houd beheer, back-ups en het intrekken van toegang gescheiden.
