1. Indholdsfortegnelse

2. Introduktion

2.1. Formål

Dette dokument indeholder en beskrivelse af hvordan installeres på et NSP Backend miljø.

2.2. Læsevejledning

Læseren forventes at have kendskab til Sundhedsdatastyrelsens platform NSP, samt generelt kendskab til WildFly applikation server, Docker, Docker Compose samt Ubuntu Linux operativ system.

2.3. Definitioner og referencer

NSP Den nationale service platform
SDS Sundhedsdatastyrelsen
Driftsvejledning GM-Facade - Driftsvejledning

3. Installation

GM-Facade anvender NSP's Continuous Integration og Continuous Deployment miljøer til byg og leverance af komponenten.

3.1. Jenkins

GM-Facade bygges med Jenkins server via følgende jobs:

NSP Leverandøren er selv ansvarlige for at pushe release versioner af GM-Facade til NSP Docker Registry igennem Jenkins.

3.2. Docker

GM-Facade består af følgende Docker image som pushes til GMAF Docker Registry:

registry.nspop.dk/components/gmaf/service

4. Krav til miljø

4.1. Krav til applikationsservere

Komponenten er udviklet og testet i Docker ved anvendelse af imaget "registry.nspop.dk/platform/nsp:4-latest".

Komponentens konfiguration er tilpasset deployment på WildFly 34 applikationsservere med OpenJDK 21.

4.2. Krav til operativsystem

Der stilles ingen krav til operativsystemet udover, at det skal være Linux, og docker skal være installeret.

4.3. Krav til adgang til andre services

GM-Facade kræver adgang til:

4.4. Krav til hardware

Der stilles ingen krav til hardware.

5. Konfiguration

I folderen "compose/configuration" findes følgende konfigurationsfiler:

gmaf.properties Konfigurationsfil for GM-Facade komponenten.
log4j2.properties Konfiguration af log4J2 (https://logging.apache.org/log4j/2.x/manual/configuration.html) 
access-handler/ Konfiguration relateret til NSP Access Handler til validering af jtph (se NSP Access Handler - Installationsvejledning)
access-handler/jtph.properties
access-handler/test-jtph.jks Keystore skal indeholde public key udsteder af jtph og ligge under alias der matcher kid, som angives i jtph.properties, men med maksimal længe på 32 tegn og kun med små bogstaver.  
access-handler/crl.skip
access-handler/log.skip
access-handler/security.skip

Alle filer skal tilrettes til de forskellige miljøer som GM-Facade installeres på. Filerne indeholder en konfiguration der passer til GM-Facade i en standalone test konfiguration.

I GM-Facade - Driftsvejledning er hver enkel fil gennemgået i detaljer.

5.1. SLA logning

SLA-Logger benyttes ikke, men i stedet logges varighed af kald til komponenten i standard loggeren. 

6. Afvikling

GM-Facade startes og stoppes med Docker Compose kommandoer.


7. Dokument Historik

3/4 2025 Martin Henriksen/SDS Etablering af dokumentation
30/6 2025 Thomas Glæsner Udfyldt


  • No labels