1. Indhold
2. Indledning
Minlog2 Consumer leveres som et projekt bestående af en Kafka Consumer løsning til at læse MinLog2 requests fra Kafka og indsætte dem i den tilhørende database.
Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til Docker, WildFly applikation server, MariaDB, Kafka og java.
2.1. Dokumenthistorik
Version | Dato | Ansvarlig | Beskrivelse |
1.1 | 09-03-2021 | KvalitetsIT | Ændret til docker setup |
1.0 | 16-09-2019 | Openminds |
2.2. Definitioner og forkortelser
Definition | Beskrivelse |
NSP | Den nationale service platform (inden for sundheds-IT) |
3. Installation
3.1. Docker
Minlog2 Consumer består af et Docker images som pushes til NSP Docker Registry under navnet:
kafkaconsumer
3.2. Docker Compose
Minlog2 Consumer leveres samtidig som et sæt af Docker Compose filer i folderen https://svn.nspop.dk/svn/components/minlog/trunk/compose.
For release x.y.z af Minlog2 Consumer findes Docker Compose filerne i folderen https://svn.nspop.dk/svn/components/minlog/tags/release-x.y.z/compose
Compose mappen indeholder 5 undermapper:
Mappe | Indhold |
---|---|
configuration | Her ligger alle de konfigurationsfiler som det forventes af driften tilretter til det anvendte miljø. Er delt op i 3 undermapper consumer, Her laves konfigugration til Minlog2 Consumer lookup registration |
database | Her ligger databasefiler som det forventes at driften lægger på en NSP database |
development | Her ligger en Docker Compose fil til brug for udvikling. Se Guide til Udviklere. |
test | Her ligger en Docker Compose fil der kan starte Minlog2 i en standalone test konfiguration. |
release | Her ligger den Docker Compose fil som det forventes driften anvender på både test og produktionsmiljøerne. |
4. Konfiguration
I folderen https://svn.nspop.dk/svn/components/minlog/trunk/compose/configuration/consumer findes følgende konfigurationsfiler:
Fil | Indhold |
---|---|
minlog2-consumer.properties | Konfiguration af Minlog2 Consumer servicen |
minlog2-ds.xml | Konfiguration af datasourses |
log4j/log4j.properties | Log opsætning af Minlog2 consumer servicen |
Filerne skal tilrettes til de forskellige miljøer hvorpå de installeres. Filerne indeholder en konfiguration der passer i en standalone test konfiguration.
5. Afvikling
Minlog2 consumer startes og stoppes med Docker Compose kommandoer.
6. Standalone test
For en standalone test af Minlog2 Consumer hentes "compose" folderen for den ønskede version med Subversion og kommandoen "docker-compose up" køres i folderen "test".
7. NSP Miljø
På et NSP miljø hentes "compose" folderen for den ønskede version med Subversion og kommandoen "docker-compose up" køres i folderen "release".
8. Kontrol
Installationen kan kontrolleres ved at kalde den indbyggede monitor del i de enkelte løsninger:
http://<server>:<port>/minlog2-consumer/monitor?details |
Status bør være ok.