1. Indholdsfortegnelse
2. Introduktion
2.1. Formål
Dette dokument indeholder en beskrivelse af hvordan Mobile Access to Health Documents (MHD) 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 | MHD - Driftsvejledning |
3. Installation
MHD anvender NPS's Continuous Integration og Continuous Deployment miljøer til byg og leverance af komponenten.
3.1. Jenkins
MHD bygges med Jenkins server via følgende jobs:
- MHD_build - Bygger koden
- MHD_push_snapshot - Pusher det nyeste snapshot image til NSP Docker Registry.
NSP Leverandøren er selv ansvarlige for at pushe release versioner af MHD til NSP Docker Registry igennem Jenkins.
3.2. Docker
MHD består af følgende Docker image som pushes til MHD Docker Registry:
|
registry.nspop.dk/components/nmhd/service |
Bemærk, i registry hedder komponenten NMHD, som står for NSP Mobile Access to Health Documents
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:
- DDS (Dokumentdelingsservice)
4.4. Krav til hardware
Der stilles ingen krav til hardware.
5. Konfiguration
I folderen "compose/configuration" findes følgende konfigurationsfiler:
| mhd.properties | Konfigurationsfil for MHD komponenten. |
| log4j2.properties | Konfiguration af log4J2 (https://logging.apache.org/log4j/2.x/manual/configuration.html) |
|
test_gm_keystore.jks |
Keystore med certifikat til signering af requests til SDS og DDS'en vha. Seal-bibliotek. |
| 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 MHD installeres på. Filerne indeholder en konfiguration der passer til MHD i en standalone test konfiguration.
I MHD - 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
MHD startes og stoppes med Docker Compose kommandoer.
7. Dokument Historik
| 3/4 2025 | Martin Henriksen/SDS | Etablering af dokumentation |
| 7/8 2025 | Thomas Glæsner/Trifork | Udfyldt dokumentation |