Sætter lige et SDS logo på 


MinLog 2

Installationsvejledning


Indhold

MinLog 2
Installationsvejledning
Indhold
Indledning
Registrering
Opslag
Læsevejledning
Dokumenthistorik
Definitioner og forkortelser
Krav til miljø
Platform
Ændringer
Tilføjelser
Konfigurationsfiler
Database
Skemaer/brugere
Tabeller
Deployment
Kontrol


Indledning

Minlog2 leveres som et projekt bestående af 2 webservice løsninger. En registreringsdel og en opslagsdel. Løsningerne bygges som ear filer og deployes til JBoss WildFly 8.2.1.Final. En eller to?

Registrering

Registreringsdelen afvikles hos dNSP med adgang til MariaDB som skal indeholde databasen "stamdata".

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

Løsningen afvikles på JBoss WildFly 8.2.1.Final med nedenstående konfigurationKrav til Java version?
Krav til MariaDB version?.
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 !!

Ændringer

Nedenstående skal ændres i konfiguration

MariaDB driver

<JBoss>/standalone/configuration/standalone.xml skal indeholde

<driver name="mariadb" module="org.mariadb">
<driver-class>org.mariadb.jdbc.Driver</driver-class>
<xa-datasource-class>org.mariadb.jdbc.MySQLDataSource</xa-datasource-class>
</driver>

<JBoss>/standalone/modules/com/mariadb/main
Skal indeholde
Module.xml bestående af
<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.3" name="org.mariadb">
<resources>
<resource-root path="mariadb-java-client-1.5.9.jar"/>
</resources>
<dependencies>
<module name="javax.api"/>
<module name="javax.transaction.api"/>
</dependencies>
</module>
Samt filen
mariadb-java-client-1.5.9.jar


Tilføjelser

Nedenstående konfigurationsfiler skal tilføjes manuelt til jBoss. Kan dette ikke scriptes i stedt for at være manuelle processer
Reply to Anni Markussen (08-06-2017, 13:44): "..."
er det ikke noget Netic gør?
Alle de omtalte filer kan dannes af bygget som beskrevet i afsnittet .

Registrering
applikations- og auditlog

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

Hvor main indeholder filen module.xml med følgende indhold:
<?xml version="1.0" encoding="UTF-8"?>
<module xmlns="urn:jboss:module:1.1" name="nsi.minlog2.registration.config">
<resources>
<resource-root path="log4j"/>
<resource-root path="."/>
</resources>
</module>

Og log4j indeholder filen log4j.properties, der indeholder konfiguration af applikationsloggen og auditloggen herunder angivelse af, hvor der logges til. Se konfigurationsfiler.

Opslag
applikations- og auditlog

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

<?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>

Og log4j indeholder filen log4j.properties, der indeholder konfiguration af applikationsloggen og auditloggen herunder angivelse af, hvor der logges til. Se konfigurationsfiler

SLA log

Filerne

  • log4j-nspslalog-minlog2.properties
  • nspslalog-minlog2.properties
  • kommuner.json

    gemmes i
    <JBoss>/standalone/configuration

    Disee indeholder konfiguration af NSPUtil log frameworket.
    Bemærk, at filernes navne ikke må ændres: NSPUtil filteret er i applikationen konfigureret til at benytte filen nspslalog-ecpr.properties.

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.properties flyttes til ovenstående folder.

Filen indeholder følgende indstillinger

  • "sql.max.logevents.allowed.in.query", som 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", som angiver hvilken SOSIFederation der initialiseres. Værdien kan være "test" eller "prod".
    -"days.to.remain.persisted", 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", angiver størrelse på batch chunks ved sletning. Værdien 10000 angiver LIMIT på delete statement
    <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="fef74684-5fae-44d8-bea0-62bb40cb8d24"><ac:plain-text-body><![CDATA-"cleanupjob.start.hour", angiver hvilken time-tid jobbet skal starte [1-23] \]></ac:plain-text-body></ac:structured-macro>
    <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="823575f6-22d6-4042-be01-45188b386669"><ac:plain-text-body><![CDATA-"cleanupjob.start.minute", angiver hvilken minut-tid jobbet skal starte [0-59] \]></ac:plain-text-body></ac:structured-macro>
    <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="c429cae9-d40c-46a5-bf8d-fb07dd991d38"><ac:plain-text-body><![CDATA-"organisationjob.start.hour", angiver hvilken time-tid jobbet skal starte [1-23] \]></ac:plain-text-body></ac:structured-macro>
    <ac:structured-macro ac:name="unmigrated-wiki-markup" ac:schema-version="1" ac:macro-id="bee33f21-f249-47e4-aabf-1c8a11c1e4e0"><ac:plain-text-body><![CDATA[-"organisationjob.start.minute", angiver hvilken minut-tid jobbet skal starte [0-59]

]]></ac:plain-text-body></ac:structured-macro>

Stamdata cache

Filen ehcache.xml skal kopieres til <Jboss>/standalone/configuration/minlog2/
Det skal nævnes at ehcache IKKE er en distribueret cache.

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 i folderen target/classes. Undtagelsen er standalone.xml som findes på JBoss i forvejen.
Filerne skal kontrolleres og evt. tilrettes før anvendelseHvordan? Hvilke filer skal være der?.


├── datasources
│   ├── minlog2-ds.xml
│   └── minlog2-stam-ds.xml
├── nsi
│   └── minlog2
│   ├── lookup
│   │   └── config
│   │   └── main
│   │   ├── log4j
│   │   │   └── log4j.properties
│   │   └── module.xml
│   └── registration
│   └── config
│   └── main
│   ├── log4j
│   │   └── log4j.properties
│   └── module.xml
└── sla
   ├── log4j-nspslalog-minlog2.properties
    └── nspslalog-minlog2.properties


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:

Registrering
applikation

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

Opslag applikation

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


KontrolHvordan kontrollere Netic at installationen er gået godt – Hvilke komponenter skal være tilgængelige? Hvilke services skal være kørende?  Slette job!!

Er der en alive test side? Svar 200 eller 500 http statuskoder..
af installation
Installationen kan kontrolleres ved at kalde den indbyggede monitor del i de enkelte løsninger:


http://<server>:<port>/minlog2-registration/monitor?details



http://<server>:<port>/minlog2-lookup/monitor?details


Status bør være ok.