Indhold

Indledning

Minlog2 leveres som et projekt bestående af 2 webservice løsninger. Jee løsningerne bygges som ear fil og deployes til JBoss WildFly 8.2.1. Registreringsdelen afvikles hos dNSP med adgang til Kafka.

Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til WildFly applikation server, Kafka og java.

Dokumenthistorik

Version	Dato	Ansvarlig	Beskrivelse
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.

Afhængigheder

Nedenstående skal være til rådighed

Kafka

NSP kafka klienten med de fornødne module konfigurationer (module.xml filer) og afhængigheder

Tilføjelser

Nedenstående konfigurationsfiler skal tilføjes manuelt til jBoss.

Alle de omtalte filer kan dannes af bygget som beskrevet i afsnittet konfigurationsfiler.

Registrering
applikations-, SLA- 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 main/log4j indeholder filerne

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

Se konfigurationsfiler for dannelse af disse tre filer.

Applikations properties

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

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

Filen indeholder følgende konfigurationer af hhv Kafka og NSP:

Property	Beskrivelse
federation=test	angiver hvilken SOSIFederation der initialiseres. Værdien kan være ”test” eller ”prod”
kafka.producer.enable=false	true vil registreringer blive publiceret til kafka false vil registreringer blive indsat direkte i databasen
kafka.producer.bootstrap.servers=localhost:9092	Se https://kafka.apache.org/documentation/#producerconfigs
kafka.producer.client.id=MinLog2-producer	Se https://kafka.apache.org/documentation/#producerconfigs
kafka.producer.key.serializer=org.apache.kafka.common.serialization.StringSerializer	Se https://kafka.apache.org/documentation/#producerconfigs
kafka.producer.value.serializer=org.apache.kafka.common.serialization.StringSerializer	Se https://kafka.apache.org/documentation/#producerconfigs
kafka.producer.request.required.acks=1	Se https://kafka.apache.org/documentation/#producerconfigs
kafka.producer.topic=MinLog2-Topic	Se https://kafka.apache.org/documentation/#producerconfigs
kafka.topic=MinLog2-Topic	Se https://kafka.apache.org/documentation/#producerconfigs
nsp.kafka.producer.component.name=MinLog2-registration-producer	Se Den Gode Brug af Kafka
nsp.kafka.producer.component.abbreviation=MinLog2-producer	Se Den Gode Brug af Kafka
nsp.kafka.producer.component.version=1.0.0	Se Den Gode Brug af Kafka
nsp.kafka.producer.service.name=produce	Se Den Gode Brug af Kafka

Konfigurationsfiler

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

I folderen <project>/code/jee/shared/shared-configuration køres
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 <project>/shared/shared-configuration/target. Undtagelsen er standalone.xml som findes på JBoss i forvejen.
Filerne skal kontrolleres og evt. tilrettes før anvendelse.

├── nsi
│   └── minlog2
│      └── registration
│          └── config
│              └── main
│                 └── log4j
│            └─ log4j.properties
│            └─ nspslalog-minlog2.properties
│                 └── module.xml
├── minlog2
   └── minlog2-register.properties

Deployment

Deployment af applikationerne via:

Registrering applikation

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

Kontrol

Installationen kan kontrolleres ved at kalde den indbyggede monitor del i de enkelte løsninger:

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

Status bør være ok.