Minlog2 leveres som et projekt bestående af 2 webservice løsninger.
Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til Docker, WildFly applikation server, Kafka og java.
Definition | Beskrivelse |
NSP | Den nationale service platform (inden for sundheds-IT) |
Minlog2 Registrering består af et Docker images som pushes til NSP Docker Registry under navnet:
registration
Minlog2 Registrering leveres samtidig som et sæt af Docker Compose filer i mappen https://svn.nspop.dk/svn/components/minlog/trunk/compose.
For release x.y.z af Minlog2 Registrering findes Docker Compose filerne i mappen 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 lookup registration, Her laves konfigugration til Minlog2 Registrering |
| 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. |
Der er kommet en ny tabel ifm. SDS-7688 til whitelisting. Den skal oprettes første gang whitelisting sættes i drift. Script til dette findes i git repository under:
compose/database/07_whitelisting.sql
I mappen https://svn.nspop.dk/svn/components/minlog/trunk/compose/configuration/registration findes følgende konfigurationsfiler:
| Fil | Indhold |
|---|---|
| minlog2/minlog2-register.properties | Konfiguration af Minlog2 Registrering servicen |
| log4j/log4j.properties | Log opsætning af Minlog2 Registrering servicen |
| log4j/nspslalog-minlog2.properties |
Filerne skal tilrettes til de forskellige miljøer hvorpå de installeres. Filerne indeholder en konfiguration der passer i en standalone test konfiguration.
Nedenstående er en beskrivelse afminlog2/minlog2-register.properties .
Filen indeholder følgende konfigurationer af hhv Kafka og NSP:
| Property | Beskrivelse |
|---|---|
federation=test | angiver hvilken SOSIFederation der initialiseres. Værdien kan være ”test” eller ”prod” |
kafka.producer.bootstrap.servers=localhost:9092 | Se https://kafka.apache.org/documentation/#producerconfigs |
kafka.producer.client.id=MinLog2-producer | Se https://kafka.apache.org/documentation/#producerconfigs |
kafka.producer.key.serializer=org.apache.kafka.common.serialization.StringSerializer | Se https://kafka.apache.org/documentation/#producerconfigs |
kafka.producer.value.serializer=org.apache.kafka.common.serialization.StringSerializer | Se https://kafka.apache.org/documentation/#producerconfigs |
kafka.producer.request.required.acks=1 | Se https://kafka.apache.org/documentation/#producerconfigs |
kafka.producer.topic=MinLog2-Topic | Se https://kafka.apache.org/documentation/#producerconfigs |
kafka.topic=MinLog2-Topic | Se https://kafka.apache.org/documentation/#producerconfigs |
nsp.kafka.producer.component.name=MinLog2-registration-producer | Se Den Gode Brug af Kafka |
nsp.kafka.producer.component.abbreviation=MinLog2-producer | Se Den Gode Brug af Kafka |
nsp.kafka.producer.component.version=1.0.0 | Se Den Gode Brug af Kafka |
nsp.kafka.producer.service.name=produce | Se Den Gode Brug af Kafka |
producer.pool.count | Antal objekter i Kafka Producer poolen. |
parentalCustody.age.limit=15 | Aldersgrænse for hvornår en borger ikke længere kan claime forældremyndighed på et barn |
audience=https://minlog | Minlogs audience streng |
powerofattorney.privileges=urn:dk:nspop:sts:minlog2:read | Tilladte fuldmagtsstrenge. Hvis flere adskilles de af komma. Eksempel: urn:dk:nspop:sts:minlog2:read,urn:dk:nspop:sts:minlog:read |
whitelisting.cache.ttl=PT1M | Time To Live for Whitelisting-cachen. Default 1 min. |
minlog2.endpoint.register=http://localhost:8080/minlog2-registration | Endpoint som bruges af DKS at angive service url, som bruges af DCC. |
Minlog2 Registrering startes og stoppes med Docker Compose kommandoer.
For en standalone test af Minlog2 Registrering hentes "compose" mappen for den ønskede version med Subversion og kommandoen "docker-compose up" køres i mappen "test".
På et NSP miljø hentes "compose" mappen for den ønskede version med Subversion og kommandoen "docker-compose up" køres i mappen "release".
Installationen kan kontrolleres ved at kalde den indbyggede monitor del i de enkelte løsninger:
http://<server>:<port>/minlog2-registration/monitor?details |
Status bør være ok.