1. Indholdsfortegnelse
2. Introduktion
2.1. Formål
Dette dokument indeholder en beskrivelse af hvordan Digital Post Adapter 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 | DPA - Driftsvejledning |
3. Installation
DPA anvender NSP's Continuous Integration og Continuous Deployment miljøer til byg og leverance af komponenten.
3.1. Jenkins
DPA bygges med Jenkins server via følgende jobs:
- DPA_build - Bygger koden
- DPA_push_snapshot - Pusher det nyeste snapshot image til NSP Docker Registry.
NSP Leverandøren er selv ansvarlige for at pushe release versioner af DPA til NSP Docker Registry igennem Jenkins.
3.2. Docker
DPA består af følgende Docker image som pushes til DPA Docker Registry:
| registry.nspop.dk/components/dpa/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 31 applikationsservere med OpenJDK 21.
4.2. Krav til operativsystem
Operativsystemer skal være Linux, og docker skal være installeret.
4.3. Krav til adgang til andre services
DPA kræver adgang til:
- "Personinformation".
- Digital Post Komponent
4.4. Krav til hardware
Der stilles ingen krav til hardware.
5. Konfiguration
I folderen "compose/configuration" findes følgende konfigurationsfiler:
| dpa.properties | Konfiguration af DPA servicen |
| log4j.properties | Opsætning af logning i servicen |
| liquibase.properties | Database-credentials til liquiba3 |
Alle filer skal tilrettes til de forskellige miljøer som DPA installeres på. Filerne indeholder en konfiguration der passer til DPA i en standalone test konfiguration.
I DPA - Driftsvejledning er hver enkel fil gennemgået i detaljer.
5.1. SLA logning
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-dpa.properties | Propertyfil, der udpeger den konkrete SLA log konfigurationsfil, der anvendes |
| log4j-nspslalog-dpa.properties | SLA log konfigurationsfil |
6. Afvikling
DPA startes og stoppes med Docker Compose kommandoer.
7. Dokument Historik
| 3/4 2025 | Martin Henriksen/SDS | Etablering af dokumentation |
| 4/6 2025 | Markus Andreassen/Trifork | Udfyldelse af dokumentation |