Konverter fra iisnode til HttpPlatformHandler

Microsoft anbefaler ikke længere iisnode til at køre Node.js på IIS. HttpPlatformHandler er den nuværende og understøttede løsning og kræver ingen ekstra konfiguration af Node.js-pipelinen.

⬇ Download onedoor-convert.zip

Berørte installationer

Denne vejledning er relevant for installationer opsat med iisnode.

Sådan tjekker du, om installationen bruger iisnode

1. Åbn IIS Manager, og vælg det site eller den applikation, der kører OneDoor.
2. Klik på Grundlæggende indstillinger (Basic Settings), og find Fysisk sti (Physical path). Det er OneDoor-installationsmappen.
3. Åbn web.config i denne mappe i en teksteditor. Du behøver ikke ændre filen.
4. Find afsnittet <handlers> under <system.webServer>. En aktiv handler med modules="iisnode" betyder, at installationen bruger iisnode. Der kan også være et afsnit med <iisnode ... />.

Bruger handleren i stedet modules="httpPlatformHandler", er installationen allerede opsat med HttpPlatformHandler og skal ikke konverteres.

Download og kør

1. Download zip-filen og pak den ud i OneDoor-installationsmappen (den mappe der indeholder package.json og web.config)
2. Højreklik på convert.bat og vælg Kør som administrator
3. Følg vejledningen på skærmen

Rollback

Scriptet gemmer en backup af den originale web.config som web.config.iisnode.bak. Kør dette for at gendanne:

$appcmd = "$env:windir\system32\inetsrv\appcmd.exe"
$path = "C:\sti\til\din\onedoor"

& $appcmd stop apppool /apppool.name:<AppPoolNavn>
Copy-Item "$path\web.config.iisnode.bak" "$path\web.config" -Force
& $appcmd start apppool /apppool.name:<AppPoolNavn>

Fordele ved HttpPlatformHandler

	iisnode	HttpPlatformHandler
Understøttet af Microsoft	Nej	Ja
Kræver særlig IIS-udvidelse	Ja	Ja (men bredere tilgængelig)
Logning	Via iisnode.yml	Via stdoutLogFile i web.config
Vedligeholdelse	Ophørt	Aktiv