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://git.nspop.dk/projects/COM/repos/minlog/browse/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 flere undermapper cleanup kafkaproxy 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://git.nspop.dk/projects/COM/repos/minlog/browse/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.proxy.url | MinLog Kafka Proxy endpoint, som anvendes i forbindelse med registreringen |
kafka.producer.proxy.maxTotalConnections | Totale antal HttpClients forbindelser der kan åbnes ved kald af MinLog Kafka Proxy |
kafka.producer.proxy.defaultMaxConnectionsPerRoute | Maksimalt antal samtidige forbindelser per enkelt endpoint (route) ved kald af MinLog Kafka Proxy |
kafka.producer.proxy.connectionTimeoutMs | Tiden (i millisekunder) klienten venter på at oprette en TCP/TLS-forbindelse, før den giver op ved kald af MinLog Kafka Proxy |
kafka.producer.proxy.socketTimeoutMs | Tiden (i millisekunder) klienten venter på data fra serveren, før den giver op ved kald af MinLog Kafka Proxy |
minlog.kafkaproxy.status.url | Statussnitfladen på MinLog Kafka Proxy. Registration kalder den fra sin egen status- og alarmsnitflade for at melde, om registreringer kan afleveres. Skal pege på samme proxy som kafka.producer.proxy.url, fx http://kafkaproxy:8080/minlog2-kafka-proxy/status. |
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 statussnitfladen:
http://<server>:<port>/minlog2-registration/status |
Svaret skal være HTTP 200 med et JSON-array, hvor Version matcher den installerede version, og hvor MinLog2 database og Kafka Proxy begge står som OK:
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
[{"Version":"2.6.0"},{"MinLog2 database":"OK"},{"Kafka Proxy":"OK"}] |
Kontrollér desuden alarmsnitfladen, som på en korrekt installation skal svare HTTP 200 med tom body:
http://<server>:<port>/minlog2-registration/alarm |
Status bør være ok.