Opgradering

OneDoor-serveren leveres som npm-pakken @septima/onedoor-server. Ny funktionalitet og fejlretninger får I ved at hæve versionsnummeret i jeres installation og installere dependencies igen.

Første gang I sætter OneDoor op under IIS, følger I Installation (herunder Run onedoor under IIS og web.config). Denne side beskriver kun skift til en ny version, når installationen allerede kører.

Find jeres nuværende OneDoor-version

Før I opgraderer, kan I tjekke hvilken OneDoor-version I kører: hold musen over logoet i øverste venstre hjørne. Så vises versionsnummeret for OneDoor.

Simpel opgradering (package.json og genstart)

Bruger I ikke IIS — eller har I allerede stoppet den proces, der kører OneDoor — er fremgangsmåden kort:

1. Ret version i package.json under dependencies for @septima/onedoor-server til den ønskede udgave (fx fra Septimas release-noter eller aftale).
2. Åbn en kommandoprompt, gå til installationsmappen (den der indeholder package.json), og kør:

yarn

3. Start sitet igen på den måde, I plejer: fx systemd-service, Docker, node-kommando med CONFIG_PATH, el.lign.

Eksempel på relevant udsnit af package.json:

{
  "type": "module",
  "dependencies": {
    "@septima/onedoor-server": "1.17.0"
  },
  "scripts": {
    "postinstall": "node postinstall"
  }
}

Behold postinstall-scriptet, så efterfølgende filer (fx til iisnode) bliver opdateret som ved første installation.

Opgradering under IIS

Kører OneDoor via IIS og iisnode, må Node ikke have åbne filer i node_modules, mens I opdaterer. Derfor: stop de application pools, der betjener sitet, opdatér og kør yarn, og start pools igen.

Stop IIS application pools

Vælg version

Redigér versionen af @septima/onedoor-server i package.json i installationsmappen (samme struktur som i afsnittet Simpel opgradering ovenfor).

Installer dependencies

I en kommandoprompt, med arbejdsmappen sat til installationsmappen:

yarn

Start IIS application pools igen

Start de samme application pools som før. Herefter kører sitet med den valgte version af @septima/onedoor-server.

Ved Kerberos/SSO ændrer opgraderingen normalt ikke SPN-opstillinger — kun hvis værtsnavn eller bindings ændres, skal IT følge op som beskrevet på Single Sign-On.