Versions Compared

Old Version 3

changes.mady.by.user Kristian Dorland

Saved on

compared with

New Version Current

changes.mady.by.user Jacob Qvortrup

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Navitabs
rootEHMI Message Handler (EMH)
includeroottrue


Indhold

Table of Contents

Introduktion

Formål

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

Komponenterne herunder, Komponenten er sammen med Domibus NSP, er 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

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

Docker

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

Leverance

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

En leverance af MSH Adapter 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

MSH EMR Adapter kræver adgang til følgende systemer:

  • Domibus NSPEMDS
  • 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 MSH AdapterEMH
log4j2.propertiesOpsætning af logning i MSH AdapterEMH
msh-adapter-ds.xmlDataSource til MSH AdapterEMH

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

MSH Adapter EMH startes og stoppes med Docker Compose-kommandoer.

...