Yleisenä huomiona, että FuturaPlan Servicen versio täytyy vastata FuturaPlanin versiota. Tarkemmin ottaen ohjelmat vaativat tietyt tietokantaversiot ja nämä versiot täytyy olla samalla tasolla.
Ensiasennus
Jos IIS:ssä ei näy "URL Rewrite"-ikonia moduulien joukossa, täytyy kyseinen moduuli asentaa erikseen. Asennuspaketti löytyy linkistä: https://www.iis.net/downloads/microsoft/url-rewrite
"URL Rewrite"-moduulin puuttuminen aiheuttaa epämääräisen web.config-virheen, eli sellaisessa tilanteessa kannattaa tarkistaa, että moduuli löytyy.
Moduulin asennuksen jälkeen tarvitaan yleensä myös IISRESET-komento komentoriviltä, jotta ikoni ilmestyy IIS-hallintapaneeliin.
FuturaPlan Service asennetaan IIS-serverin päälle Windowsissa. IIS-asennus tapahtuu samalla lailla kuin muissakin FuturaPlanin palveluissa, joten kannattaa kerrata asia täältä: Fusion Sales Servicen asennus
Poikkeuksena tosin ".NET CLR version"-kohtaan valitaan "No Managed Code".
Samalla application poolin "Advanced Settings..."-dialogista valitaan "Load User Profile" arvoksi True.
Ihan uudelle palvelimelle asennettaessa tarvitsee asentaa myös ASP.NET Core Runtime - Hosting Bundle: https://dotnet.microsoft.com/en-us/download/dotnet/5.0
Asenna myös .NET Desktop Runtime 5.0.17 saman linkin takaa. Jos ohjelmista otetaan käyttöön NET8 versio, pitää Hosting Bundle ja Desktop Runtime olla versiota 8.0.11
Appsettings.json-tiedostoon asetetaan oikea tietokantayhteys ja mahdollisesti CORS-asetukset. AllowedCorsOrigins-kenttään annetaan tarvittaessa verkkokaupan osoite.
Palvelun toimivuutta voidaan testata avaamalla selaimessa osoite: http://<palvelin>:<portti>/swagger/index.html Jos sivusto toimii, avautuu selaimeen Swagger-logolla varustettu näkymä.
Päivitys
Päivityksessa kopioidaan yksinkertaisesti asennuspaketin tiedostot vanhojen päälle, poislukien appsettings.json-tiedosto. Vanhasta kansiosta kannattaa kuitenkin tehdä varmuuskopio, jonka voi palauttaa helposti jos ongelmia ilmenee.
Virhetilanteet
500-virheissä kannattaa tarkistaa, että esim. FuturaPlan.Service.deps.json ja FuturaPlan.Service.runtimeconfig.json löytyvät asennuskansiosta. Vaikka kyseiset json-tiedostot voivat vaikuttaa turhilta, ASP.NET Core tarvitsee ne ohjelman ajoon.
Voi myös tarkistaa, että Web.config-tiedosto löytyy asennuskansiosta. Lisäksi kannattaa katsoa ettei tiedosto sisällä viittauksia %LAUNCHER_PATH% tai %LAUNCHER_ARGS% -ympäristömuuttujiin.
Epämääräinen IIS-virhe 500.19 (0x8007000d) voi viitata siihen, että Hosting Bundlea ei ole asennettu kunnolla. Esim. IIS pitää olla asennettuna ennen Hosting Bundlea, jotta ympäristö toimisi kunnolla. Tällaisessa tilanteessa voi kokeilla korjata Hosting Bundlen asennuksen.