Indhold

Introduktion

Formål

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

Domibus'en er 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

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

• https://jenkins.nspop.dk/job/EMR/ (burde måske omdøbes?)

Docker

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

• http://registry.nspop.dk/components/emr/domibus-nsp

Leverance

Domibus'en leveres som et sæt Docker Compose-filer i folderen "compose/release". Herudover findes der tilhørende konfiguration i "compose/configuration".

...

Domibus'en er en umodificerede udgave af den officielle Domibus, men pakket ned i et NSP-specifikt docker image med tilhørende konfiguration. Domibus'en leveres med dens egen MySQL- og ActiveMQ-services, som er tilføjet compose-filerne under release. Der er også en "domibus-db-migration-nsp" som opretter databasen første gang servicen starter op via Flyway og de officielle Domibus sql-scripts.

Konfiguration

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

...

Selve konfigurationen gennemgås mere detaljeret i Driftsvejledningen.

PMode.xml

Inden upload af PMode filen skal den opdateres, så den matcher konfiguration omkring keystore alias, GLN, og URL. Med udgangspunkt i domibus/compose/configuration/pmode/pmode-nsp.xml skal følgende gøres: 

• Fire steder i filen står "sosi:alias_system". Dette ændres så det matcher alias'et i keystoren
• <identifier partyId="gln" partyIdType="ap-identifier"/> skal opdateres så "gln" er GLN-nummeret som domibus er konfigureret med i SMP'en
• endpoint="http://emr-ap:8080/domibus/services/msh"> opdateres så URL'ens scheme+host+port matcher hvor domibus'en kan nåes

Afvikling

Domibus startes og stoppes med Docker Compose-kommandoer.

...

1. Åben browseren på http://<host>:<port>/domibus/login, for hver host, hvor host og port erstattes af den konkrete host og port hvor der kører en Domibus.
2. Klik ind på "PMode → Current".
3. Tryk upload og vælg en passende pmode fra filsystemet. TODO: Uafklaret hvilken pmode-config NSP skal køre med.

Database

Databasen er en standard "mysql:8.4" uden ændringer og med minimal opsætning. 

...