Opgradering – Windows / IIS

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

• Automatisk opgradering – batch-fil
• Manuel opgradering

---

Automatisk opgradering – batch-fil

⬇ Download onedoor-upgrade.zip

1. Pak ZIP-filen ud og placer upgrade.bat og upgrade.cjs i installationsmappen — den samme mappe der indeholder package.json
2. Højreklik på upgrade.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

Scriptet viser løbende status for hvert trin og afslutter med en bekræftelse når opgraderingen er gennemført.

Find App Pool-navn i IIS Manager

Åbn IIS Manager og klik på Application Pools i venstre panel. I listen finder du den App Pool der svarer til dit OneDoor-site under kolonnen Name — det er dette navn du skal angive når scriptet spørger.

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.

Forudsætninger

Krav	Beskrivelse
Administratorrettigheder	Du skal køre som lokal administrator eller domænebruger med administratorrettigheder. Højreklik på upgrade.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.
App Pool-navn	Du skal kende navnet på den IIS App Pool der kører OneDoor. Se nedenfor hvordan du finder det.
Septima-credentials	Brugernavn og adgangskode til Septimas npm-pakkeregister. Kontakt Septima hvis du ikke har disse.

---

Manuel opgradering

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

Forudsætninger (kun første gang)

Inden du kan opgradere 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 opgraderer, 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 opgradering

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: Opgraderingen ændrer normalt ikke SPN-opstillinger. Kun hvis værtsnavn eller IIS-bindings ændres, skal IT følge op som beskrevet på Single Sign-On.