Indhold


Indledning

Minlog2 Opslag leveres som et projekt bestående af 3 webservice løsninger. JEE løsningerne bygges som ear filer og deployes til JBoss WildFly 8.2.1.Final.

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 WildFly applikation server, MariaDB og java.

Dokumenthistorik

Version

Dato

Ansvarlig

Beskrivelse

1.811-05-2020KvalitetsITOpdateret konfigurations properties samt tabeller der skal gives adgang til. 
1.704-06-2019OpenmindsYderligere specifikation af installationer
1.620-09-2018OpenmindsYderligere 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)


Krav til miljø

Platform

Den primære del af løsningen afvikles på JBoss WildFly 8.2.1.Final med nedenstående konfiguration. 

Løsningen er udviklet med JDK 1.8 og er testet mod MariaDB version 10.x.

OBS ! CRL foretages af platformen – er slået fra i lookupid !!

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

Opret module.xml i main bestående af:

<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="nsi.minlog2.lookup.config">
  <resources>
    <resource-root path="log4j"/>
    <resource-root path="."/>
  </resources>
</module>

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.


Kommuner

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

gemmes i <JBoss>/standalone/deployments.

De beskriver konfiguration af database til hhv. applikationen og adgange på virksomhedsniveau.

Applikations properties

Opret folder
<Jboss>/standalone/configuration/minlog2/

Filen minlog2-lookup.properties flyttes til ovenstående folder.

Filen 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=0

angiver hvilken minut-tid jobbet skal starte [0-59]

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. 

IDWS

Tilret idws.properties filen:
org.apache.ws.security.crypto.merlin.file=<Jboss>/standalone/configuration/minlog2/idws-keystore.jks
org.apache.ws.security.crypto.merlin.truststore.file==<Jboss>/standalone/configuration/minlog2/idws-truststore.jks
samt evt. passwords til de 2 keystores.
Filerne

  • idws.properties
  • idws-keystore.jks
  • idws-truststore.jks
    skal kopieres til <Jboss>/standalone/configuration/minlog2/


Konfigurationsfiler

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

Byg med: mvn clean install –P <env>

Hvor <env> er dev, niab, test eller prod.

Dette vil danne de fleste af de nødvendige filer som en zip-fil i folderen shared/shared-configuration/target. Undtagelsen er standalone.xml som findes på JBoss i forvejen.
Filerne skal kontrolleres og evt. tilrettes før anvendelse.


├── datasources
│   ├── minlog2-ds.xml
│   └── minlog2-stam-ds.xml
├── nsi
│   └─ minlog2
│      └─ lookup
│          └─ config
│              └─main
│                  └─ log4j
│                     └─ log4j.properties
│                     └─ nspslalog-minlog2.properties
│                 └─ module.xml
├── minlog2
   └── kommuner.json
   └── minlog2-lookup.properties
   └── idws.properties
   └── idws-truststore.jks
   └── idws-keystore.jks



Database

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

Skemaer

Der skal være adgang til følgende MariaDB skemaer:

Der skal oprettes brugere med tilstrækkelige privilegier og med adgang til skemaerne.

Tabeller

I MinLog2 kan tabellerne oprettes via "initial_schema.sql".

I stamdata forventes følgende tabeller – med indhold:

Deployment

Deployment af applikationerne via:

Opslag applikation

Filen
lookup-ear/target/minlog2-lookup.ear
skal kopieres til
<JBoss>/standalone/deployments


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.