Indhold
Indledning
Minlog2 Opslag leveres som et projekt bestående af 3 webservice løsninger.
Opslag
Opslagsdelen afvikles hos cNSP og kræver adgang til MariaDB med database "minlog2" og "stamdata".
I det følgende beskrives forudsætninger, samt skridt ved første installation og efterfølgende installationer.
Læsevejledning
Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til Docker, WildFly applikation server, MariaDB og java.
Dokumenthistorik
Version | Dato | Ansvarlig | Beskrivelse |
| 1.10 | 09-03-2021 | KvalitetsIT | Ændret til docker setup |
| 1.9 | 04-11-2020 | KvalitetsIT | Beskrivelse af idws.properties opdateret. |
| 1.8 | 11-05-2020 | KvalitetsIT | Opdateret konfigurations properties samt tabeller der skal gives adgang til. |
| 1.7 | 04-06-2019 | Openminds | Yderligere specifikation af installationer |
| 1.6 | 20-09-2018 | Openminds | Yderligere specifikation som følge af ny borgerservice og Kafka |
1.5 | 21-11-2017 | Openminds | Ny webservice til borger |
1.4 | 17-10-2017 | Openminds | Tilføjet kommune data |
1.3 | 28-09-2017 | Openminds | Properties til OrganisationJob – kommunetabel fjernet. |
1.2 | 06-09-2017 | Openminds | Ehcache setup |
1.1 | 10-08-2017 | Openminds | Properties til CleanUp job. Kommunetabel. |
1.0 | 15-06-2017 | Openminds |
Definitioner og forkortelser
Definition | Beskrivelse |
NSP | Den nationale service platform (inden for sundheds-IT) |
Installation
Docker
Minlog2 Opslag består af et Docker images som pushes til NSP Docker Registry under navnet:
lookup
Docker Compose
Minlog2 Opslag 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 Opslag 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, Her laves konfigugration til Minlog2 Opslag 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. |
Konfiguration
I mappen https://svn.nspop.dk/svn/components/minlog/trunk/compose/configuration/lookup findes følgende konfigurationsfiler:
| Fil | Indhold |
|---|---|
| minlog2-ds.xml | Konfiguration af datasourses |
| minlog2-stam-ds.xml | Konfiguration af datasourses mod stamdata |
| minlog2/minlog2-lookup.properties | Konfiguration af Minlog2 Opslag servicen |
| minlog2/idws-keystore.jks | Keystore |
| minlog2/idws.properties | Konfiguration af idws |
| minlog2/kommuner.json | Kommune opslysninger |
| log4j/log4j.properties | Log opsætning af Minlog2 Opslag 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.
Tilføjelser
Nedenstående er en yderligere beskrivelse af minlog2/minlog2-lookup.properties og minlog2/idws.properties.
Filen minlog2/minlog2-lookup.properties indeholder følgende indstillinger:
| Property | Beskrivelse |
|---|---|
sql.max.logevents.allowed.in.query=10000 | angiver det maks antal logevent der kan søges på ved lookup. Overskrides denne, returneres en fejl med besked om at indsnævre søgningen |
federation=test | angiver hvilken SOSIFederation der initialiseres. Værdien kan være ”test” eller ”prod” |
days.to.remain.persisted=730 | angiver hvor mange dage entries findes i DB. Værdien 730 er 2 år herefter slettes de i natlig kørsel |
sql.delete.batch.size=10000 | angiver størrelse på batch chunks ved sletning. Værdien 10000 angiver LIMIT på delete statement |
| sql.stamdata.notfound.error.message="Stamdata kunne ikke fremsøges" | angiver fejlbesked hvis stamdata ikke kan fremsøges |
sleep.after.batch=10000 | angiver hvor mange ms der skal ventes inden næste "sql.delete.batch.size" slettes. |
cleanupjob.runtime.max=25000 | angiver hvor lang tid hvert job må bruge. For at undgå timeout på HTTP-kald, er værdien pt. sat til 25 sekunder (25000 millisekunder) |
| minutes.to.log.own.data=15 | angiver hvor mange minutter der går mellem log af egne data indenfor samme døgn. |
Filen minlog2/idws.properties indeholder nedenstående properties.
| Property | Beskrivelse |
|---|---|
org.apache.ws.security.crypto.merlin.keystore.type | Keystore type. Skal være jks. |
org.apache.ws.security.crypto.merlin.keystore.password | Password til keystore. |
org.apache.ws.security.crypto.merlin.keystore.alias | Keystore alias. Skal typisk være sosi:alias_system. |
org.apache.ws.security.crypto.merlin.file | Sti til keystore. |
| federation | Hvilket federation der skal anvendes. Skal enten være test eller prod. |
Afvikling
Minlog2 Opslag startes og stoppes med Docker Compose kommandoer.
Standalone test
For en standalone test af Minlog2 Opslag hentes "compose" mappen for den ønskede version med Subversion og kommandoen "docker-compose up" køres i mappen "test".
NSP Miljø
På et NSP miljø hentes "compose" mappen for den ønskede version med Subversion og kommandoen "docker-compose up" køres i mappen "release".
Kontrol
Installationen kan kontrolleres ved at kalde den indbyggede monitor del:
http://<server>:<port>/minlog2-lookup/monitor?details http://<server>:<port>/minlog2-lookupid/monitor?details http://<server>:<port>/minlog1-lookup/monitor?details |
Status bør være ok.