Installationsvejledning til BBRGD integration

BBR integrationen indeholder 3 løsninger

• BBR Miljø Import 
• BBR Byggesag
• BBR Miljø - Upload af tanke

Krav til serveren

• Kravspecifikation
• Serveren skal kunne nå https://sg.bbr.dk/
• Udgående firewall regler skal tillade netværkstrafik (TCP) til følgende URL'er:
  • https://sg.bbr.dk/External/DAFGateway/
  • https://secureTokenservice.nemlog-in.dk/SecurityTokenService.svc
  • https://saml.sts-prod-bbr.dk
• Certifikater(er) til kommunikation med BBR skal være installeret på serveren
  
  • Certifikat til løsningen BBR Miljø Import
    Kræver Geokons funktionsignatur, rekvireres her
    
    
  • Certifikater til løsningerne BBR Upload og BBR Byggesag
    Kræver Geokons BBR indberetter certifikater (downloades nederst på siden)
    Kræver kommuneudstedt funktionsignatur og systembruger. Læs mere her
    Kræver Geokons funktionsignatur, rekvireres her

Krav til service

• BBR-serviceversion skal være kompatibel med GeoEnviron version. Versionsafhængighed kan læses på downloadsiden.
• SQL Authenticated bruger (med brugernavn og password) til GeoEnviron databasen.
  Rettigheder: db_datareader og db_datawriter 
  Brugeren giver servicen mulighed for at skrive i GeoEnviron databasen.
  Brugeren skal indtastes under guiden Service Installation nedenfor.

• BBR-service skal have rettighed til at skrive i sin egen installationsfolder på serveren, hvor den er installeret
  
  
• BBR-service skal have adgang til en lokal ejendomsdatabase Cognito eller LOIS, såfremt ejernavne skal kunne hentes.
  Dette kræver en SQL Authenticated bruger (med brugernavn og adgangskode) til LOIS (db_datareader rettighed) eller Cognito database (EMDBGroupOne rettighed)
  

Krav til lokale pc brugere

• GeoEnviron klienterne skal kunne tilgå BBR-servicens webservice. 
  Eksempel http://server:port/GeoEnvironAPI?singlewsdl. Læs flere detaljer i Service Installationens punk 6.

Krav til opsætning i GeoEnviron 

*Disse oplysninger er typisk indsat ved 1. installation

Sikr dig at opsætningsparametre til BBR løsningen er angivet i gruppen BBRGD integration på fanen Fælles opsætning i GeoEnviron.

1. Log på GeoEnviron med administrator login
2. Vælg menupunktet System Adm./Opsætning/Systemopsætning
3. Vælg fanen Fælles opsætning og Gruppe/Overskrift = BBRGD integration
4. Angiv værdi for hver række - og husk at trykke på knappen Gem  for at gemme oplysningerne

• Kommunenummer = Kommunens nummer
• URL til BBR webservice = Url til BBR servicens indbyggede webservice
  (Punkt 6 under Service Installation)
• Serienummer på certifikat = Nummerret på kommunens udstedte funktioncertifikat til kommunikation med BBR. 

Installation af certifikater

I BBR løsningen kan der være flere certifikater i spil alt efter, hvilken del af løsningen man benytter:

• BBR Miljø Import (import af data fra BBR)
  Her benyttes 1 certifikat (Geokons funktionssignatur). Dette rekvireres ved henvendelse til Geokons support.
  
  
• BBR Miljø Upload (Upload af data til BBR)
  
  
• BBR Byggesag Upload (Upload af data til BBR)
  
  Ved BBR Upload løsningerne skal installeres ialt 3 certifikater til BBR.
  De to Certifikater WSP og STS kan hentes ved at downloade Certifikater.zip nederst på denne side.
  Vejledning til udstedelse af indberetter certifikat kan findes her 

Certifikat(er) installeres på serveren, hvorpå servicen skal køre, dette gøres i følgende steps:

1. Filen med certifikatet uploades til serveren så det kan bruges herfra
2. Certifikatet (inklusiv privatnøgle, hvis det er indberettercertifikatet, som installeres) indlæses i "Local Machine Certificate Store" vha. af Microsoft Management Console, certifikatmanager snap-in, som åbnes med følgende guide: http://msdn.microsoft.com/en- us/library/ms788967(v=vs.110).aspx
3. Ekspander "certificates" og "Personal"
4. Højre klik på "Personal" og vælg "All Tasks/Import..."
5. Udvælg fil (og tast evt. password for indberettercertifikat) og fuldfør installationen
6. Hvis det er BBR WSP Prod certifikatet, som er installeret, skal følgnede udføres:
   1. Lokaliser certifikatet "TRUST2408 OCES Primary CA" i certificate manager, sædvanligvis under "Personal" eller "Third Party Root Certification Authorities"
   2. Højreklik på certifikater og under "certificate purposes" vælg "Enable all purposes for this certificate"
      

Service installation

NB! Skal du opgradere en eksisterende service, kan du klikke her. 

1. Sørg som det første for, at downloade seneste version af din servicen fra denne side her  
2. Anbring den nyeste version af msi-pakken GeoEnviron Service BBRGD X.X.X.X.msi på den valgte servers skrivebord
3. Dobbeltklik på pakken og nedenstående installationsguide åbner sig
   

   Under installation vil du blive promptet af user access control for at acceptere installation.  
   
   
   
   
   
   

4. Tryk Next og udfyld parametrene
   
   
   I ovenstående trin kan du indtaste databaseparametre (databasenavn, databaseserver, login, password og Port)
   
   BBRGD TCP Port: Geokon har valgt at sætte 8000 som default TCP port for denne service. Som kunde har du mulighed for at benytte denne. 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 6
   
   

   Parameter	Indhold	Eksempel
   Servernavn(SQL server)	Navn på SQL server hvor GeoEnviron databasen ligger	SQLserverX
   Database (GeoEnviron)	Navn på GeoEnviron database	Geo_Kommunenavn
   GeoEnviron bruger	Servicens SQL Authenticated bruger	Geo_BBR
   GeoEnviron kodeord	Ulovlige tegn: &\<>"`
   GeoEnviron service URL	Angiv http://localhost	http://localhost
   GeoEnviron service Port	Angiv hvilken port servicen kontaktes på	8000

   
   
   Tryk Next
   
   
   
5. Færdig
6. Sikr dig at der i GeoEnviron er angivet, hvilken server og port, BBRGD servicen er benytter her: 
   Åbn GeoEnviron/ System Adm/ System opsætning/ Fælles opsætning/ BBRGD integration
   
   Indsæt nedenstående url i GeoEnviron: 
   http://server:port/GeoEnvironAPI?singlewsdl
   Erstat "server" med navnet på den server, hvorpå GeoEnviron Jupiter service kører
   Erstat "port" med det TCP portnummer, som du har angiver i installationsguiden
   
   Eksempel:
   http://devapp1:8000/GeoEnvironAPI?singlewsd
   
   
   

7.  Gå ind og start GeoEnviron Service BBRGD i Windows

Efter installation

Tjek om servicen starter planmæssigt op i Windows Eventviewer

1. Start servicen under Services (vælg Start -> kør -> services.msc)
2. Gå derefter ind in Windows Event viewer under GeoEnviorn Eventlog og se om services er

Ved installtion af service 1. gang, husk da at aktivere modulet BBR i GeoEnviron

Før det er muligt at bruge funktionaliteten, som integrationerne mellem GeoEnviron og Jupiter tilbyder, skal modulet aktiveres. Dette gøres under menupunktet System Adm./Opsætning/Administration af moduler. 

Når modulet er aktiveret og GeoEnviron genstartes, vil Jupiter integrationen være tilgængelige.

Certifikatdownload