Indhold

Introduktion

Formål

Dette dokument indeholder en beskrivelse af hvordan EMH kan installeres på et NSP-miljø.

Komponenten er sammen med EMDS en del af EHMI MeddelelsesRegistrering (EMR).

Læsevejledning

Læseren forventes at have kendskab til Sundhedsdatastyrelsens platform NSP, samt generelt kendskab til Docker, Docker Compose, MySQL og lidt om EHMI.

Installation

Jenkins

EMH bygges ind i et NSP image via NSP Jenkins-serveren. Der bygges med følgende job:

Docker

EMH består af et Docker image som pushes til NSP Docker Registry:

Leverance

EMH leveres som en Docker Compose-filer i folderen "compose/release". Herudover findes der tilhørende konfiguration i "compose/configuration".

En leverance af EMH består af compose-filerne, konfigurationen samt tilhørende tags af det byggede Docker image.

Der findes pt. følgende compose-filer under "compose/release":

  • docker-compose-adapter.yaml (servicen)
  • docker-compose-db.yml (liquibase-migrering af db)

Krav til miljø

Krav til applikationsservere

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

Krav til operativsystem

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

Krav til adgang til andre services

EMR kræver adgang til følgende systemer:

  • EMDS
  • DROS EHMI
  • EDS (ekstern service)
  • STS

Konfiguration

I folderen "compose/configuration" findes følgende relevante konfigurationsfiler, som indlæses når docker compose startes op:

adapter.propertiesProperties til EMH
log4j2.propertiesOpsætning af logning i EMH
msh-adapter-ds.xmlDataSource til EMH

Selve konfigurationen gennemgås mere detaljeret i Driftsvejledningen.

Liquibase

Database-ændringer til servicen køres på med Liquibase. Dette gøres i praksis ved at køre "release/docker-compose-db.yml" med kommandoen:

docker-compose -f compose/release/docker-compose-db.yml up --build

Bemærk, at "compose/configuration/liquibase.properties" skal indeholde de relevante database-credentials.

Afvikling

EMH startes og stoppes med Docker Compose-kommandoer.

På et NSP miljø hentes "compose" folderen for den ønskede version og kommandoen "docker-compose -f <compose-file> up" køres i folderen "release" for docker-compose-adapter.yaml.


  • No labels