Dette dokument indeholder en beskrivelse af hvordan installeres på et NSP Backend miljø.
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.
| NSP | Den nationale service platform |
| SDS | Sundhedsdatastyrelsen |
| Driftsvejledning | GM-Facade - Driftsvejledning |
GM-Facade anvender NSP's Continuous Integration og Continuous Deployment miljøer til byg og leverance af komponenten.
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.
GM-Facade består af følgende Docker image som pushes til GMAF Docker Registry:
| registry.nspop.dk/components/gmaf/service |
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.
Der stilles ingen krav til operativsystemet udover, at det skal være Linux, og docker skal være installeret.
GM-Facade kræver adgang til:
Der stilles ingen krav til hardware.
I folderen "compose/configuration" findes følgende konfigurationsfiler:
| gmaf.properties | |
| 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.
Konfigurationsfiler til SLA logning konfigureres i nedenstående filer. De følger standarden for SLA logning og det bør derfor ikke være nødvendigt at ændre i disse.
| nspslalog-gmaf.properties | Propertyfil, der udpeger den konkrete SLA log konfigurationsfil, der anvendes |
| log4j-nspslalog-gmaf.properties | SLA log konfigurationsfil |
GM-Facade startes og stoppes med Docker Compose kommandoer.
| 3/4 2025 | Martin Henriksen/SDS | Etablering af dokumentation |