Beroenden

Ledningsägarmodulen kräver att nedanstående programvaror finns installerade:

• IIS 7 eller högre.
• Web Deployment Tool.
  • Hämtas från microsoft.com.
  • Installera den nedladdade filen.
• .NET Framework 3.5 (Installeras via server manager)
• SQL Server
  • en tom databas med tillhörande användare med minst följande rättigheter:
    • data_reader
    • data_writer
    • ddladmin
  • rekommenderad collation för databasen är:
    • Finnish_Swedish_CI_AS

Installationsförfarande

Paketinstallation

Ledningsagarmodul kommer paketerad som ett Web Deployment package och kan installeras med hjälp av Web Deployment Tool. Programvaran går också att installera via kommandoraden med hjälp av det medföljande .cmd-scriptet. Kör man detta script utan flaggor får man upp hjälptexten som ligger i paketnamn.deploy-readme.txt. Hjälpen ger mer information om vilka flaggor som kan användas.

Web Deployment Tool i IIS 7/7.5/8 (rekommenderad)

Packa upp zip-filen som laddats ned, eller erhållits från Ledningskollen i en valfri katalog i serverns filsystem. Navigera i IIS Manager till roten i den site där du vill installera Ledningsägarmodulen och klicka på Import Application (under deploy menyn nere till höger).

Figur 1. Detaljvy som visar var man hittar Import Application i IIS Manager

Navigera till katalogen där du packade upp .zip-filen enligt ovan. Välj .zip-filen som innehåller ledningsägarmodulen-paketet. Filen är namngiven som "ledningsagarmodul-...zip". Installera modulen med valfritt namn.

Kommandoradsinstallation

Packa upp zip-filen som laddats ned, eller erhållits från Ledningskollen, i en valfri katalog. Se filen readme.txt för detaljerade instruktioner.

Initial konfiguration

Efter att applikationen är installerad behöver man göra följande:

• Gör en kopia av filen Web.config.template och döp om kopian till Web.config
  • Web.config.template ligger direkt i roten i Ledningsägarmodulens installationskatalog.
• Kör programmet ConfigurationWizard.exe som ligger i bin-katalogen i Ledningsägarmodulens installationskatalog.
  • Detta program måste köras med Administratörs-rättigheter och kommer att skapa en Application Pool som Ledningsägarmodulen kommer använda.

Fyll även i följande fält i ConfigurationWizard:

• Modulens användarnamn och lösenord till Ledningskollen (Ledningskollen Login). Ledningsägarmodulen måste ha ett eget användarkonto i Ledningskollen med rollen Ledningsägarmodul. Detta konto kan ni själva skapa om ni har rollen Användaradministratör i Ledningskollen. I annat fall hänvisas till Ledningskollens support för att skapa detta konto.
• Sökväg till den katalog där Ledningsägarmodulen skall leta efter ledningsnätsinformation i form av filer (Geometries).
• Koordinatsystem för filerna med ledningsnätsinformation. (Source coordinate system).
• Den URL som användare av Ledningsägarmodulen i er organisation kan använda för att logga in och administrera Ledningsägarmodulen. Inloggning i Ledningsägarmodulen sker med ett konto som har rollen Ledningsägare Admin i Ledningskollen. (Module Web Site)
• Databaskonfiguration för den databas som Ledningsägarmodulen skall använda för att spara information om ledningsnät och inställningar (Database)

Då alla fält är inmatade, klicka på knappen "Save". Efter att inställningarna sparats avslutas ConfigurationWizard. Starta ConfigurationWizard igen och klicka nu på knappen Test Config Settings. Om alla symbolerna lyser grönt är konfigurationen färdig. I annat fall korrigera inställningarna och spara igen.

Figur 2. ConfigurationWizard

Övrig konfiguration

Application Pool

Application pool Ledningsagarmodul (Classic 32-bit) skapas när man trycker på Save i Configuration Wizard. Ställ in så att Ledningsägarmodulen använder sig av denna Application pool. Hur denna inställning görs beror på vilken version av IIS som finns installerad.

Om du använder IIS 7/7.5/8 så görs denna inställning genom att

• I IIS Manager gå till roten för den webbplats som valdes vid installeringen av Ledningsägarmodulen.
• Välj Avancerade inställningar i menyn längst till höger
• I det fönster som öppnats välj Application pool Ledningsagarmodul (Classic 32-bit)

Rättigheter

Den användare som kör Application pool behöver ha nedanstående läs- och skrivrättigheter. Förvalt blir detta IIS_IUSRS på Windows Server 2012. Ändra helst detta till Network Service istället.

Skrivrättigheter

Skrivrättigheter till den katalog som applikationen är installerad i. Katalogen används för att skriva loggfiler och lokala kopior av geografisk information.

Inställningar för katalogerna kan ändras i Web.config om man vill spara filerna på annat ställe * RepositoryDirectoryPath (AppSetting) - lokala kopior av geografisk information * Loggfilen ställs in i avsnittet log4net under FileAppender i elementet file.

Det bästa sättet att verifiera att skrivrättigheterna är rätt uppsatta är att filen Lemmy.log skapas och fylls med loggningsinformation. Denna fil skapas då applikationen startas, vilket enklast är gjort genom att öppna en webbläsare och gå till den lokala addressen för Ledningsägarmodulen.

Läsrättigheter

Läsrättigheter till den katalog med geografisk information som angavs i Configuration Wizard (Watch Directory).

Om filerna med geografisk data ligger på en Windowsutdelning från en annan server krävs det att Application pool körs av en användare som har rätt att ansluta till denna utdelning. Detta innebär vanligtvis att samma användare med samma lösenord måste finnas på både servern där Ledningsägarmodulen skall köras och på servern där filerna med geografisk data ligger. Alternativt kan en domänanvändare används.

Uppstart av Ledningsägarmodul

Applikationen startas när man ansluter till webapplikationen första gången och kommer i normala fall inte att stängas av efter det. Ändrar man i Web.config eller startar om Application pool måste man dock starta applikationen på nytt genom att ansluta till websiten.

När Ledningsägarmodulen är uppstartad första gången kommer man att kunna se de inställningar som går att göra för modulen under fliken modulinställningar. En förutsättning är att man loggar in med ett Ledningsägare-admin konto på Ledningskollen. För information om dessa inställningar hänvisas till dokumentet Ledningsägarmodul – Användarmanual.