Installationsvejledning til BOM service (Byg og Miljø)

Kravspecifikation
Certifikat til Byg og Miljø portalen skal være installeret på serveren. Kan rekvireres hos Geokon her
Servicen anvender Microsoft .NET Framework version 4 - minimum version 4.7.2

SQL Authenticated bruger (med brugernavn og password) til GeoEnviron databasen.
Brugeren giver servicen mulighed for at skrive i GeoEnviron databasen.
Brugeren skal indtastes under installationen i guiden nedenfor.
En AD servicebruger med brugernavn og password - Adgangskoden må ikke kunne udløbe!
Brugeren skal have skrive/læse-rettigheder til det filshare, som er angivet i GeoEnviron under: Stamdata/ Fælles Stamdata/ sag og journal/ parametre.

Brugerens navn og password indsætte i GeoEnvirons opsætningsparametre under - se eksempel nedenfor:
System Adm./Opsætning/Systemopsætning/Byg og Miljø
Tilslutningsaftale
Geokon fremsender en tilslutningsaftale, som skal underskrives af kommunen. Aftalen giver Kombit lov til at åbne op for kommunikationen til Byg og Miljø via Geokons funktionsignatur.

Certifikatet installeres på serveren, hvorpå servicen skal køre, dette gøres i følgende steps:

Filen med certifikatet uploades til serveren så det kan bruges herfra
Certifikatet (inklusiv privatnøgle) indlæses i Local Machine store, hvor servicen er installeret
Denne åbnes med følgende guide: http://msdn.microsoft.com/en- us/library/ms788967(v=vs.110).aspx
Ekspander certificates og personal
Højre klik på personal og vælg All Tasks/Import...
Udvælg fil og tast password (Certificate store bør være automatisk udfyldt)
Noter certifikatets serienummer, når det er installeret
Indtast certifikatets serienummer i GeoEnviron under menupunktet:
System Adm./Opsætning/Systemopsætning, fanen Fælles opsætning og gruppe/overskrift = Byg og Miljø. (vist i skærmbilledet nedenfor)

Sikre dig at du har installeret funktioncertifikat på serveren
Anbring den nyeste version af msi-pakken GeoEnviron Service BoMX.X.X.X.msi på det valgte servers skrivebord
Dobbeltklik på pakken og nedenstående installationsguide åbner sig
Tryk Next

Indtast databaseparametre (databasenavn, databaseserver, login, password og BoM TCP Port)

BoM TCP Port: Geokon har valgt at sætte 9000 som default TCP port for denne service. Som kunde har du mulighed for at benytte denne port. Du har også fri mulighed for at vælge en anden port. Porten må bare ikke være optaget
Husk dit valg af portnummer til punkt 7
Tryk Install i skærmbilledet nedenfor
Finish og installation af MSI-pakken er fuldført
Sikre dig at der i GeoEnviron står angivet, hvilken server og port, servicen er installeret på her:
Åbn GeoEnviron/ System Adm/ System opsætning/ Fælles opsætning/ Byg og Miljø

Indsæt i følgende:
http://server:port/GeoEnvironAPI?singlewsdl
Erstat "server" med navnet på den server, hvorpå GeoEnviron BoM service driftes
Erstat "port" med det TCP portnummer, som du har angiver i installationsguiden

Eksempel:
http://geokontest:9000/GeoEnvironAPI?singlewsdl
Der skal være åbent fra GeoEnviron klient/sagsbehandler pc mod server:port, hvilket kan kræve åbning i firewall - f.eks. TCP port 9000
Færdig

Efter installation

Tjek om servicen starter planmæssigt op

Start servicen under Services (vælg Start -> kør -> services.msc)
Gå derefter ind in Windows Event viewer under GeoEnviorn Eventlog og se om services er startet op uden fejl
En fejlfri opstart giver nedenstående skærmbillede. Her står hvornår tjenesten starter og stopper. Ved hver opstart kontrolleres om der er korrekt forbindelse til de nødvendige komponenter. Der kan også her stå forklaring på, hvorfor tjenesten ikke kan starte.

Log-information

Serverprogrammet logger oplysninger flere steder, da det kører som en Windows tjeneste på en server, brugerne ikke har direkte adgang til.

Køsystemets log i GeoEviron databasen. Her ligger al log-information. Log'en findes ved at logge ind som administrator og vælge menupunktet System Adm./Opsætning/Serverprogrammer.