Versions Compared

Old Version 2

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).

  • MSH Adapter

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:

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

Selve konfigurationen gennemgås mere detaljeret i Driftsvejledningen.

Liquibase

Afvikling

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 MSH stubben 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 hver docker-compose fil-adapter.yaml.