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

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

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