Uppdatera från adminportalen

Nya versioner av Eurion installeras med ett klick i adminportalen under System Updates. Det behövs ingen SSH-inloggning. Installationen tar en säkerhetskopia först, kör databasmigreringarna, byter version och kontrollerar att allt fungerar. Misslyckas något återgår servern automatiskt till den tidigare versionen.

Så fungerar det

• En tjänst på servern, eurion-updater, letar efter nya versioner i uppdateringskanalen en gång per dygn.
• Varje version är ett signerat paket. Servern installerar bara paket som är signerade med en nyckel den redan litar på (nyckeln i den installerade versionen, aldrig en nyckel i själva paketet). Även kanalens versionslista måste vara signerad.
• Paket med en äldre version än den installerade, och deltapaket gjorda för en annan version, avvisas.
• Varje åtgärd hamnar i granskningsloggen.

Kanaler

updates.channel_url	Betydelse
https://updates.eurion.se/stable/ (standard)	Eurions stabila versioner.
"" (tomt)	Offline-server: ingen kontakt med uppdateringskanalen. Uppdateringar laddas upp som fil, se nedan.

Inställningen görs i konfigurationsfilen (avsnittet updates).

Vem får göra vad

	Administratör	Superadministratör
Se installerad version och om en uppdatering finns	ja	ja
Check now, se loggen, avbryta en schemalagd uppdatering		ja
Install now, Install tonight at 02:00, ladda upp en fil		ja, efter lösenordsbekräftelse

Lösenordsbekräftelse

Innan en uppdatering installeras, schemaläggs eller laddas upp frågar portalen efter ditt lösenord igen (Confirm your password). Bekräftelsen gäller i 5 minuter.

Konton med SSO

Bekräftelsen kräver ett lokalt lösenord. Ett konto som loggar in med Microsoft Entra ID får beskedet att lösenordsbekräftelse inte är tillgänglig. Använd ett lokalt superadministratörskonto för uppdateringar.

Installera en uppdatering

1. Logga in på https://admin.example.se som superadministratör och öppna System Updates. Finns en ny version är menyposten markerad.
2. Under Update available ser du version, storlek och versionsinformation.
3. Välj Install now, eller Install tonight at 02:00.
4. Bekräfta med ditt lösenord.

Förloppet visas på sidan: hämtning, signaturkontroll och installation i sex steg:

Steg	Vad som händer	Om det misslyckas
Kontroll	Kontrollsummor, att versionen är nyare, att ett deltapaket passar, att diskutrymmet räcker	Inget har ändrats.
1/6 Backup	Säkerhetskopia av alla databaser och Redis	Inget har ändrats.
2/6 Loading images	De nya avbildningarna läses in	Inget har ändrats.
3/6 Installing the deployment kit	Det nya kitet läggs på plats; konfiguration och lösenord följer med	Automatisk återgång
4/6 Regenerating configuration	Inställningarna skrivs om för den nya versionen; nya lösenord läggs till vid behov	Automatisk återgång
5/6 Migrating databases and switching	Migreringar körs medan den gamla versionen fortfarande svarar, sedan byts ändrade containrar	Automatisk återgång
6/6 Verifying	Alla containrar friska, appen och API:t svarar, inga omstarter under 60 sekunder	Automatisk återgång

Medan tjänsterna startar om tappar sidan kontakten en kort stund och visar The services are restarting for the update. Den återansluter själv, oftast inom en minut. Användarna märker ungefär en minuts avbrott.

När det är klart visar sidan Updated to …. Under Log finns installationsloggen.

Schemalägga

Install tonight at 02:00 gäller klockan 02.00 i din webbläsares tidszon. Du kan avbryta med Cancel fram till dess. Schemaläggning finns bara för versioner från kanalen, inte för uppladdade filer.

Automatisk återgång

Misslyckas steg 3–6 gör installationen så här:

1. Det tidigare kitet läggs tillbaka (det misslyckade sparas i /opt/eurion/deploy.failed).
2. Databasen återställs från säkerhetskopian i steg 1, men bara om en migrering hann ändra den. Annars behålls databasen som den är, så inga meddelanden går förlorade.
3. Den tidigare versionen startas igen (dess avbildningar finns kvar på servern).
4. Containrar som bara finns i den nya versionen tas bort.
5. Samma hälsokontroll körs.

Sidan visar då Update to … failed, rolled back to … och orsaken. Skicka loggen till support.

Gå tillbaka efter en lyckad uppdatering

Upptäcker ni ett fel efter uppdateringen kan du gå tillbaka till föregående version. Det görs på servern:

sudo eurion-ctl rollback-update

Du skriver YES för att bekräfta. Databasen behålls som den är.

Om den nya versionens migreringar gör att den gamla versionen inte fungerar med databasen kan du även återställa säkerhetskopian som togs före uppdateringen:

sudo eurion-ctl rollback-update --restore-db

Data försvinner med --restore-db

Allt som skrivits sedan uppdateringen (meddelanden, filer i databasen, ändringar) försvinner. Använd det bara om support ber dig, eller om den gamla versionen inte startar utan.

Bara den senaste uppdateringen kan ångras på det här sättet.

Frigöra disk efter en lyckad uppdatering

Den förra versionens avbildningar ligger kvar så att du kan gå tillbaka. När du är säker på den nya versionen:

sudo eurion-ctl prune-images 1.6.1   # den GAMLA versionen

Kommandot vägrar om någon container fortfarande använder versionen.

Offline-server

Med updates.channel_url: "" kontaktar servern aldrig uppdateringskanalen. Gör så här i stället:

1. Hämta uppdateringsfilen (eurion-update-<version>.tar) från Eurion och för över den till en dator som når adminportalen.
2. Öppna System Updates → Upload an update file → Choose file (högst 4 GB).
3. Bekräfta med ditt lösenord. Filens signatur kontrolleras innan den erbjuds.
4. Välj Install now.

Du kan också installera filen direkt på servern, se Manuell uppdatering.

Nya tredjepartstjänster

En uppdatering som lägger till en ny tredjepartstjänst (till exempel en ny databas eller ett verktyg) hämtar den avbildningen från Docker Hub eller ghcr.io. En server helt utan internet behöver då få avbildningen inläst i förväg (docker load); kontakta support.

Deltapaket

Kanalen kan erbjuda ett mindre deltapaket som bara innehåller det som ändrats sedan din version. Servern väljer det automatiskt om det passar din version exakt, annars det fullständiga paketet. Ett deltapaket för en annan version avvisas.

Förutsättningar

• Ledigt diskutrymme för Docker på minst fyra gånger avbildningsfilens storlek.
• eurion-updater körs: systemctl status eurion-updater.
• Utgående HTTPS till updates.eurion.se (om kanalen används).

Fungerar inte uppdateringen från portalen, se Manuell uppdatering och Felsökning.