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.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) |
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: | 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 | 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=15 | angiver hvor mange minutter der går mellem log af egne data indenfor samme døgn. |
|
IDWS | Tilret idws.proeprties filen. Den 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. |
|
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.