Oppdatering av Nex1on-motoren og tilbakerulling: slik oppdaterer du i ro og mak

Å oppdatere motoren er to handlinger på én gang: filene byttes ut, og databasen bringes i orden. Det er skummelt bare når det ikke finnes noen vei tilbake. I Nex1on finnes det alltid en vei tilbake: motoren lager selv en databasekopi og et gjenopprettingspunkt for filene, ingenting installeres uten at du sier ja, og hvis nettstedet ikke svarer etter en oppdatering, kan forrige versjon gjenopprettes med ett trykk. Nedenfor: hvordan du oppdaterer i ro og mak, og hva du gjør hvis noe går galt.

Slik får du vite at en ny versjon er ute #

Hvis oppdateringssjekk er slått på, spør motoren nex1on.com én gang i uken om en ny versjon er ute (bare domenet, motorversjonen og PHP-versjonen sendes). Er det det, får du en e-post «Nex1on … er tilgjengelig» (én e-post per versjon), og siden «System → Oppdateringer» sier «Versjon … er ute. Les hva som er endret, og bestem selv». Ingenting installeres av seg selv: e-posten forteller bare at det finnes noe å lese. Sjekken kan slås av: i «Innstillinger → Generelt» setter du «Se etter oppdateringer» til «aldri».

Hva motoren gjør under en oppdatering #

Oppdateringssiden går trinn for trinn, og du ser hvert av dem:

1. Den sjekker kravene: om PHP er ny nok, om det er nok ledig plass, og om motorens filer kan skrives.
2. Den laster ned arkivet og sjekker signaturen: et arkiv som ikke stemmer med den signerte hashen, blir ikke installert.
3. Den lager en databasekopi og et gjenopprettingspunkt for filene (en kopi tas også før databaseendringene brukes). Kan det ikke lages en kopi, starter ikke oppdateringen.
4. Den bytter ut motorens filer. Mens de byttes, ser besøkende en vedlikeholdsside. Mappene config og storage røres ikke, innstillinger, opplastinger og data blir som de var, og de gamle filene havner i kopien.
5. Den bruker databaseendringene (migreringer) og sjekker at nettstedet svarer.

Trinn 1. Forbered deg #

Åpne «System → Oppdateringer». Før du trykker «Oppdater», gjør du tre ting.

1. Les hva som er endret. Siden «Før oppdatering til versjon …» viser beskrivelsen av versjonen. Den fullstendige endringsloggen ligger i filen CHANGELOG i motormappen.
2. Sjekk kravene. Motoren viser hvilken PHP du har og hvilken som trengs, hvor mye ledig plass det er, og om motorens filer kan skrives. Er noe ikke oppfylt, er knappen «Oppdater» slått av, og det står hva som må rettes.
3. Se etter om du har endringer i motorens filer. Har du endret motorens filer, erstatter oppdateringen dem med filene fra utgivelsen, og endringene dine går tapt. Siden sier hvor mange slike filer det er, og tilbyr «Lagre endringene mine som arkiv». Det er bedre å holde endringene dine i ditt eget tema eller din egen modul: en oppdatering rører dem ikke.

Lag også en egen databasekopi («System → Sikkerhetskopier og flytting → Sikkerhetskopier av databasen»): oppdateringen tar sin egen, men vanen med å ta en kopi før hvert risikabelt steg lønner seg en dag.

Trinn 2. Oppdater #

Trykk «Oppdater». Siden går trinn for trinn, og det er best å ikke forstyrre den: lukket du fanen, går du tilbake til samme side, og oppdateringen fortsetter fra samme sted. Når alt har gått bra, sier motoren «Motoren er oppdatert til versjon …, databasen er i orden og nettstedet svarer», og databasekopien blir liggende på siden «Oppdatering». Hvis noen moduler ikke ble oppdatert, sies det separat, med navnet på kopien.

Trinn 3. Hvis noe går galt #

Motoren sjekker selv om nettstedet svarer etter at filene er byttet. Er svaret feil, gjenoppretter den forrige versjon uten deg: «Nettstedet svarer ikke riktig. Gjenoppretter forrige versjon…», og deretter «Forrige versjon er gjenopprettet». Du får en e-post «Oppdatering til … ble avbrutt». Klarte den ikke å gjenopprette automatisk, åpner du gjenopprettingssiden (adressen vises på oppdateringssiden), skriver inn nøkkelen og trykker «Gjenopprett forrige versjon nå». Filene fra forrige versjon ligger også som et arkiv i storage/recovery/files.zip. Årsaken til at oppdateringen ikke gikk gjennom, sies rett ut:

• Den nye versjonen trenger nyere PHP. Oppdater PHP hos webhotellet eller vent.
• Arkivet stemte ikke med den signerte hashen. Nedlastingen ble skadet: gjenta den.
• Arkivet er større enn lovet eller det mangler plass. Frigjør litt diskplass.
• Oppdateringsserveren svarte ikke, eller nedlastingen ble avbrutt. Prøv igjen senere.
• Databaseendringene ble ikke brukt. Detaljene står i feilloggen; kopien fra før starten er lagret.
• En annen versjon kom ut på serveren mens du klikket. Åpne oppdateringssiden på nytt.

Oppdatering for hånd #

Hvis serveren ikke får skrive til motorens filer, eller du vil oppdatere selv, gjør du det for hånd: last ned arkivet med den nye versjonen fra utgivelsessiden, pakk det ut og last det opp over motorens filer, men la config og storage være i fred. Åpne deretter seksjonen «Oppdatering» og trykk «Bruk»: databaseendringene brukes ikke av seg selv. FTP-passord trenger du ikke skrive inn i panelet: de tas ikke imot her og lagres ikke.

Hva du bør sjekke #

• Du har lest beskrivelsen av versjonen og listen over krav.
• Det finnes ingen egne endringer i motorens filer, eller hvis det gjør det, er de lagret som arkiv.
• Det finnes en fersk databasekopi, og du vet hvor den ligger.
• Det er satt en nettstedsnøkkel i config/local.php (app.key, minst 32 tegn): uten den er gjenoppretting utilgjengelig.
• Gjenopprettingsnøkkelen er lagret til oppdateringen er bekreftet.
• Etter oppdateringen har du åpnet forsiden, noen undersider og panelet, og «Systemtilstand» viser ikke noe rødt.

Hvis noe går galt #

• Knappen «Oppdater» er slått av. Oppfyll kravene som er listet på siden: PHP-versjonen, den ledige plassen, skrivetilgang til filene.
• «Gjenoppretting er utilgjengelig: angi en nettstedsnøkkel». Legg app.key (minst 32 tegn) inn i config/local.php; uten den kan gjenopprettingsbilletten ikke signeres.
• Gjenoppretting er utilgjengelig: det kunne ikke skrives til mappene storage/recovery og public, eller ZIP-utvidelsen mangler. Gi serveren skrivetilgang til disse mappene, og slå på ZIP hos webhotellet.
• Oppdateringen stoppet halvveis. Nettstedet kan være i en blandet tilstand: trykk «Gjenopprett forrige versjon nå» eller bruk gjenopprettingsnøkkelen.
• De nye funksjonene dukket ikke opp. Oppdateringssiden sier hvor mange databaseendringer som venter på å bli brukt: inntil de er det, kjører nettstedet på de gamle tabellene.

Hva nå #

Oppdater ut fra beskrivelsen, ikke av vane: les hva som er endret, og avgjør om du trenger det nå. Og sørg for at veien tilbake er prøvd, ikke antatt: en rolig dag åpner du gjenopprettingssiden og forsikrer deg om at nettstedsnøkkelen er på plass.