Opdatering – Windows / IIS

Kører OneDoor med IIS og iisnode, kan opdateringen køres automatisk med en batch-fil eller manuelt trin for trin.

• Automatisk opdatering – batch-fil
• Manuel opdatering

---

Automatisk opdatering – batch-fil

⬇ Download onedoor-update.zip

1. Pak ZIP-filen ud og placer update.bat og update.cjs i installationsmappen — den samme mappe der indeholder package.json
2. Højreklik på update.bat og vælg Kør som administrator
3. Angiv versionsnummer og App Pool-navn når du bliver spurgt
4. Første gang kan du blive bedt om at logge ind med Septima-credentials og indtaste nødvendige tokens eller adgangsoplysninger til de services, installationen bruger

Scriptet viser løbende status og afslutter først med en bekræftelse, når OneDoor svarer via IIS. Opstarten kan tage op til et minut. Kontrollen afprøver alle sitets HTTP- og HTTPS-bindings direkte på serveren (HTTPS først), så et site, der kun svarer på HTTPS, godkendes, selvom der stadig ligger en gammel HTTP-binding. Ved hver kørsel gennemgår scriptet alle config.yml under installationens config-mappe og organisationernes øvrige YAML-konfigurationer for DAWA→DAR-migration, uanset installeret OneDoor-version. Mangler der et Septima API-token til DAR, bliver du bedt om at angive det. Hvis den valgte OneDoor-version allerede er installeret, men konfigurationen skal rettes, geninstalleres pakken ikke; scriptet opdaterer konfigurationen og genstarter IIS App Pool.

Første gang med en ny brugerkonto

Hvis Yarn ikke er installeret eller brugerkontoen ikke er logget ind på Septimas npm-register, håndterer scriptet det automatisk. Begge dele sker kun én gang per brugerkonto på serveren.

Kan npm ikke starte på serveren (fx Class extends value undefined is not a constructor or null), bruger scriptet en allerede installeret Yarn — global eller lokal i installationsmappen — til at kontakte pakkeregistrene. Er Yarn heller ikke installeret, stopper scriptet med en vejledning i at reparere npm/Node.js.

Token til den nye adresseservice

Token er påkrævet

OneDoors nye adresseservice kræver en kundespecifik token. Sørg derfor for at have tokenet klar, inden du starter opdateringen.

Hvis installationen ikke allerede indeholder en token, vil opdateringsscriptet bede dig om at indtaste den. Indtastningen er skjult, så tokenet ikke vises i konsollen. Har installationen allerede en token, bevares den automatisk.

Scriptet finder alle params.yml og params.yaml rekursivt under installationens config-mappe, også i undermapper som organisations\furesoe\configurations\kommune. Alle fundne filer får tilføjet parameters.septimaapi.token, hvis det mangler eller er en pladsholder, uanset om DAR bruges i konfigurationen. Eksisterende tokens overskrives ikke. En organisationsmappe uden params.yml stopper ikke længere opdateringen, og scriptet opretter ikke nye params.yml-filer.

Hvis du endnu ikke har modtaget din token, er du velkommen til at kontakte jorgen@septima.dk, så hjælper vi dig videre.

Forudsætninger

Krav	Beskrivelse
Administratorrettigheder	Du skal køre som lokal administrator eller domænebruger med administratorrettigheder. Højreklik på update.bat og vælg Kør som administrator.
Node.js installeret	Node.js skal være installeret på serveren og tilgængeligt i PATH. Tjek med node --version i en kommandoprompt.
Adgang til installationsmappen	Du skal have læse- og skriveadgang til den mappe der indeholder package.json.
Adgang til dokumentationssitet	Serveren skal kunne hente https://onedoor-docs.septima.dk/onedoor-docs/scripts/update.cjs via HTTPS. Bliver hentningen blokeret, viser scriptet en vejledning: hent filen manuelt i en browser, kopier den som update.cjs til installationsmappen og tryk en tast for at fortsætte.
Septima-credentials	Brugernavn og adgangskode til Septimas npm-pakkeregister. Kontakt Septima hvis du ikke har disse.

---

Manuel opdatering

Foretrækker du at udføre opdateringen manuelt, følger du trinene nedenfor.

Forudsætninger (kun første gang)

Inden du kan opdatere OneDoor-pakken, skal du have adgang til Septimas npm-pakkeregister og have Yarn installeret. Disse to trin skal kun udføres én gang per bruger der er logget ind på serveren.

Log på Septimas npm-pakkeregister

Åbn en kommandoprompt og kør:

npm login --scope=@septima --registry=https://packages.septima.dk/repository/npm-hosted/

Angiv de credentials du har fået af Septima, når der spørges om brugernavn og adgangskode.

Installér Yarn pakkehåndtering

Forsøg først at installere Yarn globalt:

npm install -g yarn

Hvis du får en fejl om manglende rettigheder, kan du i stedet installere Yarn lokalt i installationsmappen. Gå til installationsmappen og kør:

npm install yarn

Brug derefter .\ node_modules\.bin\yarn.cmd i stedet for yarn i de efterfølgende trin.

---

Find din nuværende OneDoor-version

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

---

Trin-for-trin opdatering

1. Stop IIS application pools

Stop de application pools der betjener OneDoor-sitet, inden du redigerer filer.

2. Ret version i package.json

Redigér versionen af @septima/onedoor-server i package.json i installationsmappen til den ønskede udgave (fx fra Septimas release-noter eller aftale):

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

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

3. Installér dependencies

Åbn en kommandoprompt, gå til installationsmappen (den der indeholder package.json), og kør:

yarn

Har du installeret Yarn lokalt (uden -g), bruges i stedet:

.\node_modules\.bin\yarn.cmd

4. 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.

---

SSO / Kerberos: Opdateringen ændrer normalt ikke SPN-opstillinger. Kun hvis værtsnavn eller IIS-bindings ændres, skal IT følge op som beskrevet på Single Sign-On.