Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Minlog2 Opslag leveres samtidig som et sæt af Docker Compose filer i folderen mappenhttps://svn.nspop.dk/svn/components/minlog/trunk/compose.

For release x.y.z af Minlog2 Opslag findes Docker Compose filerne i folderen mappenhttps://svn.nspop.dk/svn/components/minlog/tags/release-x.y.z/compose


Compose mappen  indeholder 5 undermapper:

MappeIndhold
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

databaseHer
ville alle de
ligger databasefiler som det forventes at driften lægger på en NSP database
ligge, hvis der var nogen
developmentHer ligger en Docker Compose fil til brug for udvikling. Se Guide til Udviklere.
testHer ligger en Docker Compose fil der kan starte Minlog2 i en standalone test konfiguration.
releaseHer ligger den Docker Compose fil som det forventes driften anvender på både test og produktionsmiljøerne.


Konfiguration

I mappenhttps://svn.nspop.dk/svn/components/minlog/trunk/compose/configuration/lookup findes følgende konfigurationsfiler:


FilIndhold
minlog2-ds.xmlKonfiguration af datasourses
minlog2-stam-ds.xmlKonfiguration af datasourses mod stamdata
minlog2/minlog2-lookup.propertiesKonfiguration af Minlog2 Opslag servicen
minlog2/idws-keystore.jksKeystore
minlog2/idws.propertiesKonfiguration af idws
minlog2/kommuner.jsonKommune opslysninger
log4j/log4j.propertiesLog 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 konfigurationsfiler skal tilføjes manuelt til jBoss. Alle de omtalte filer kan dannes af bygget som beskrevet i afsnittet .

...

Applikations-, SLA- og auditlog

Opret folder
<JBoss>/modules/nsi/minlog2/lookup/config/main/log4j

...

er en yderligere beskrivelse af minlog2/minlog2-lookup.properties og minlog2/idws.properties.

Filen minlog2/minlog2-lookup.properties

main/log4j indeholder

  • log4j.properties, der indeholder konfiguration af applikationsloggen, auditloggen og SLA-log - herunder angivelse af, hvor der logges til.
  • nspslalog-minlog2.properties

Se konfigurationsfiler for dannelse af disse tre filer.

...

Filen kommuner.json

Gemmes i
<JBoss>/standalone/configuration/minlog2

Filen er hentet fra dawa.aws.dk (i skrivende stund: http://dawa.aws.dk/kommuner).

...

Database

Filerne

  • minlog2-ds.xml
  • minlog2-stam-ds.xml

...

Applikations properties

...

indeholder følgende indstillinger:

PropertyBeskrivelse
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

cleanupjob.start.hour=3
angiver hvilken time-tid jobbet skal starte [1-23]
cleanupjob.start.minute=*/10

angiver hvilken minut-tid jobbet skal starte [0-59]. Her er  angivet at jobbet skal afvikles hvert 10 minut

cleanupjob.runtime.max=240000
angiver hvor lang tid hvert job må bruge. Da transaktioner får timeout efter 5 minutter, så er værdien pt. sat til 4 minutter (240000 millisekunder)
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. 
minutes.to.log.own.data=15angiver hvor mange minutter der går mellem log af egne data indenfor samme døgn. 

IDWS

Tilret


Filen minlog2/idws.

...

properties indeholder nedenstående properties.

PropertyBeskrivelse
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.
federationHvilket federation der skal anvendes. Skal enten være test eller prod.

Konfigurationsfiler

Det er muligt at danne konfigurationsfiler svarende til et bestemt miljø fra maven.

...

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".

Database

Der er udarbejdet sqlfiler til blandt andet oprettelse af minlog2 skema – find dem i …/shared/shared-configuration/src/main/resources/sql.

...

  • Autorisation2
  • Organisation
  • v2_Person
  • v2_ForaeldreMyndighedRelation
  • v2_BarnRelation
  • v2_UmyndiggoerelseVaergeRelation
  • Yderregister_v4
  • SOR2SorEntity

Deployment

Deployment af applikationerne via:

...

Opslag applikation

...


Kontrol

Installationen kan kontrolleres ved at kalde den indbyggede monitor del:

...