Installationsvejledning til Service Jupiter

Services Jupiter er et serverprogram (Windows service) som står for dataudvekslingen mellem GeoEnviron og Jupiter.
Servicen henter data, herunder prøver og analyser samt kodelister, fra Jupiter til
GeoEnviron databasen. Når data er modtaget, kan de ses under fanen ”Jupiter” i
Vandindvindings-kalenderen.

Nyt ved installation af Jupiter service 2.x

Installation af certifikat
2. Danmarks Miljøportal udskifter geuswebs-encryption certifikat til Jupiters webservices tirsdag d. 7/9-2021 - se denne artikel

Krav til serveren
Service Jupiter anvender Microsoft .NET Framework version 4 - minimum version 4.7.2

Udgående firewall regler skal tillade netværkstrafik (TCP) til følgende URL:
4. http://data.geus.dk/miljoeportal.pcjupiterxl.1.0/PCJupiterXL.svc

Installation af Service
6. Angiv i GeoEnviron hvilket brugernavn/adgangskode, Jupiter servicen benytter til at læse data fra Jupiter

Krav til serveren

• Kravspecifikation
• Serveren skal kunne tilgå http://webs.geus.dk/
• Geuswebs-encryption.crt skal være installeret på serveren (hentes nederst på siden)
• Certifikat til miljøportalen skal være installeret på serveren (hentes nederst på siden)
• Udgående firewall regler skal tillade netværkstrafik (TCP) til følgende URL'er:
  
  1. http://webs.geus.dk/miljoeportal.groundwater.read.1.2.0/jupiterread.svc
  2. http://webs.geus.dk/miljoeportal.groundwater.write.1.2.0/jupiterwrite.svc
  3. http://webs.geus.dk/miljoeportal.groundwater.write.1.2.0/jupiterwrite.svc
  4. http://data.geus.dk/miljoeportal.pcjupiterxl.1.0/PCJupiterXL.svc 
• Network DTC access skal enables på SQL-serveren, hvor Geoenviron databasen ligger 

Krav til service

• 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 installationen i guiden nedenfor.
  
  
• Jupiter-serviceversion skal være kompatibel med GeoEnviron version. Versionsafhængighed kan læses på downloadsiden.
  Jupiter-service skal have rettighed til at skrive i sin egen installationsfolder på serveren, hvor den er installeret
  

Krav til lokale PC brugere

• GeoEnviron klient/sagsbehandler pc skal kunne tilgå Jupiter-servicens webservice (Http + port), som er beskrevet i installationsvejledningens punkt 6. Når servicen er installeret, skal adressen for webservicen indsætte i GeoEnvirons opsætningsparametre
  Eksempel: http://server:port/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 8001

Installation af certifikat

Der skal installeres to certifikater til Jupiter. Certifikaterne installeres på serveren, hvorpå servicen skal køre, dette gøres i følgende steps:

1. Filen med certifikaterne uploades til serveren så det kan bruges herfra
2. Certifikaterne indlæses i Local Machine store,hvor servicen er installeret
   1. STS certifikat
   2. geuswebs-encryption certifikat

3. Brug følgende guide: http://msdn.microsoft.com/en- us/library/ms788967(v=vs.110).aspx
4. Ekspander certificates og personal
5. Højre klik på personal og vælg All Tasks/Import...
6. Udvælg fil og tast password (Certificate store bør være automatisk udfyldt)

Vær desuden opmærksom på at ”Network DTC Access” skal enables på SQL-serveren. Dette
gælder kun, hvis ”Jupiter/GeoEnviron-Service” installeres på en anden server end SQL
Serveren. Det er muligt at læse mere om DTC Access her
Download certifikater på denne side (se i bunden af artiklen).

Installation af Service

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 Jupiter 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)
   
   Jupiter TCP Port: Geokon har valgt at sætte 8001 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	SQLserver
   Database (GeoEnviron)	Navn på GeoEnviron database	Geo_Kommunenavn
   GeoEnviron bruger	Servicens SQL Authenticated bruger	Geo_Jupiter
   GeoEnviron kodeord	Ulovlige tegn: &\<>"`
   GeoEnviron service URL	Angiv http://localhost	http://localhost
   GeoEnviron service Port	Angiv hvilken port servicen kontaktes på	8001

   
   Tryk Next
   
   
   
5. Finish og installation af MSI-pakken er fuldført
   
   
   Vent på at Shield afvikles...
   
   
   
   
6. Sikr dig at der i GeoEnviron er angivet, hvilken server og port, Jupiter servicen benytter her:
   
   Åbn GeoEnviron/ System Adm/ System opsætning/ Fælles opsætning/ Jupiter
   
   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:8001/GeoEnvironAPI?singlewsd

   Angiv i GeoEnviron hvilket brugernavn/adgangskode, Jupiter servicen benytter til at læse data fra Jupiter. Når adgangskoden er udløbet og skiftet, skal den også ændres her.

    

7. Gå ind og start GeoEnviron Service Jupiter i Services 
8. Færdig
   
   
9.  

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

Tjek evt. vandindvindingskalenderen i GeoEnviron

Åbn GeoEnviron og klik på fanen Vandindvindingskalender og verificer at Servicen har stemplet aktiviteter ind i loggen dags dato.

Ved installation af service 1. gang, husk da at aktivere modulet Jupiter 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.