Uppdatera Nex1on-motorn och backa tillbaka: så uppdaterar du i lugn och ro

Att uppdatera motorn är två saker på en gång: filerna byts ut och databasen bringas i ordning. Det är skrämmande bara när det inte finns någon väg tillbaka. I Nex1on finns alltid en väg tillbaka: motorn gör själv en databaskopia och en återställningspunkt för filerna, ingenting installeras utan ditt klartecken, och om webbplatsen inte svarar efter en uppdatering kan föregående version återställas med ett tryck. Nedan: hur du uppdaterar i lugn och ro och vad du gör om något går fel.

Hur du får veta att en ny version har kommit #

Om sökning efter uppdateringar är påslagen frågar motorn nex1on.com en gång i veckan om en ny version har kommit (bara domänen, motorns version och PHP-versionen skickas). Om den har det får du ett mejl ”Nex1on … finns” (ett mejl per version), och sidan ”System → Uppdateringar” visar ”Version … har kommit. Läs vad som har ändrats och bestäm själv”. Ingenting installeras av sig självt: mejlet talar bara om att det finns något att läsa. Sökningen kan stängas av: i ”Inställningar → Allmänt” sätter du ”Sök efter uppdateringar” till ”aldrig”.

Vad motorn gör under en uppdatering #

Uppdateringssidan går steg för steg, och du ser vart och ett:

1. Den kontrollerar kraven: om PHP är tillräckligt ny, om det finns tillräckligt med ledigt utrymme och om motorns filer går att skriva till.
2. Den laddar ner arkivet och kontrollerar signaturen: ett arkiv som inte stämmer med den signerade hashen installeras inte.
3. Den gör en databaskopia och en återställningspunkt för filerna (en kopia tas också innan databasändringarna tillämpas). Om en kopia inte kan göras startar uppdateringen inte.
4. Den byter ut motorns filer. Medan de byts ser besökarna en sida om ”underhåll”. Mapparna config och storage rörs inte, inställningar, uppladdningar och data förblir som de var, och de gamla filerna hamnar i kopian.
5. Den tillämpar databasändringarna (migreringar) och kontrollerar att webbplatsen svarar.

Steg 1. Förbered dig #

Öppna ”System → Uppdateringar”. Innan du trycker på ”Uppdatera” gör du tre saker.

1. Läs vad som har ändrats. Sidan ”Före uppdatering till version …” visar versionens beskrivning. Den fullständiga ändringsloggen finns i filen CHANGELOG i motorns mapp.
2. Kontrollera kraven. Motorn visar vilken PHP du har och vilken som behövs, hur mycket ledigt utrymme det finns och om motorns filer går att skriva till. Om något inte är uppfyllt är knappen ”Uppdatera” avstängd, och det står vad som behöver åtgärdas.
3. Se efter om du har ändringar i motorns filer. Om du har ändrat motorns filer ersätter uppdateringen dem med versionens filer och dina ändringar går förlorade. Sidan visar hur många sådana filer det finns och erbjuder ”Spara mina ändringar som arkiv”. Det är bättre att hålla dina ändringar i ett eget tema eller en egen modul: en uppdatering rör dem inte.

Gör också en egen databaskopia (”System → Kopior och flytt → Säkerhetskopior av databasen”): uppdateringen tar sin egen, men vanan att göra en kopia före varje riskabelt steg lönar sig förr eller senare.

Steg 2. Uppdatera #

Tryck på ”Uppdatera”. Sidan går steg för steg och det är bäst att inte störa den: om du stängde fliken går du tillbaka till samma sida, och uppdateringen fortsätter där den var. När allt har gått bra säger motorn ”Motorn är uppdaterad till version …, databasen är i ordning och webbplatsen svarar”, och databaskopian finns kvar på sidan ”Uppdatering”. Om några moduler inte uppdaterades står det separat, med kopians namn.

Steg 3. Om något går fel #

Motorn kontrollerar själv om webbplatsen svarar efter att filerna har bytts ut. Om svaret är fel återställer den föregående version utan din hjälp: ”Webbplatsen svarar inte som den ska. Återställer föregående version…” och sedan ”Föregående version har återställts”. Du får ett mejl ”Uppdateringen till … avbröts”. Om den inte kunde återställa automatiskt öppnar du återställningssidan (adressen visas på uppdateringssidan), anger nyckeln och trycker på ”Återställ föregående version nu”. Föregående versions filer finns också som arkiv i storage/recovery/files.zip. Orsaken till att uppdateringen inte gick igenom anges rakt ut:

• Den nya versionen kräver en nyare PHP. Uppdatera PHP hos webbhotellet eller vänta.
• Arkivet stämde inte med den signerade hashen. Nedladdningen blev skadad: gör om den.
• Arkivet är större än utlovat eller det finns inte tillräckligt med utrymme. Frigör diskutrymme.
• Uppdateringsservern svarade inte eller nedladdningen avbröts. Försök igen senare.
• Databasändringarna tillämpades inte. Detaljer finns i felloggen; kopian från före starten är sparad.
• En annan version kom ut på servern medan du klickade. Öppna uppdateringssidan igen.

Uppdatera för hand #

Om servern inte får skriva till motorns filer, eller om du vill uppdatera själv, gör du det för hand: ladda ner arkivet med den nya versionen från versionssidan, packa upp det och ladda upp det ovanpå motorns filer, utan att röra config och storage. Öppna sedan avsnittet ”Uppdatering” och tryck på ”Tillämpa”: databasändringarna tillämpas inte av sig själva. FTP-lösenord behöver inte anges i panelen: de tas inte emot här och lagras inte.

Vad du ska kontrollera #

• Du har läst versionens beskrivning och listan över krav.
• Det finns inga egna ändringar i motorns filer, eller om det finns, är de sparade som arkiv.
• Det finns en färsk databaskopia och du vet var den ligger.
• En webbplatsnyckel är angiven i config/local.php (app.key, minst 32 tecken): utan den går det inte att återställa.
• Återställningsnyckeln är sparad tills uppdateringen har bekräftats.
• Efter uppdateringen har du öppnat startsidan, några undersidor och panelen, och ”Systemets hälsa” visar inget rött.

Om något går fel #

• Knappen ”Uppdatera” är avstängd. Uppfyll kraven som anges på sidan: PHP-versionen, det lediga utrymmet, skrivrättighet till filerna.
• ”Återställning är otillgänglig: ange en webbplatsnyckel”. Lägg in app.key (minst 32 tecken) i config/local.php; utan den kan återställningsbiljetten inte signeras.
• Återställning är otillgänglig: det gick inte att skriva till mapparna storage/recovery och public, eller så saknas ZIP-tillägget. Ge servern skrivrättighet till de här mapparna och slå på ZIP hos webbhotellet.
• Uppdateringen avbröts halvvägs. Webbplatsen kan vara i ett blandat tillstånd: tryck på ”Återställ föregående version nu” eller använd återställningsnyckeln.
• De nya funktionerna dök inte upp. Uppdateringssidan visar hur många databasändringar som väntar på att tillämpas: tills de är det arbetar webbplatsen med de gamla tabellerna.

Vad härnäst #

Uppdatera utifrån beskrivningen, inte av vana: läs vad som har ändrats och bestäm om du behöver det nu. Och se till att vägen tillbaka är prövad, inte antagen: en lugn dag öppnar du återställningssidan och kontrollerar att webbplatsnyckeln finns på plats.