Page History
...
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.
...
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
Der foretages ingen whitelistning til MinLog2 - der henvises til driftsleverandøren som kan, såfremt det ønskes, begrænse adgangen i netværket.
Tilføjelser
Nedenstående konfigurationsfiler skal tilføjes manuelt til jBoss.
...
Registrering
applikations-, SLA- og auditlog
...
- 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.
Installation
Docker
Minlog2 Registrering består af et Docker images som pushes til NSP Docker Registry under navnet:
registration
Docker Compose
Minlog2 Registrering leveres samtidig som et sæt af Docker Compose filer i folderen https://svn.nspop.dk/svn/components/minlog/trunk/compose.
For release x.y.z af Minlog2 Registrering findes Docker Compose filerne i folderen https://svn.nspop.dk/svn/components/minlog/tags/release-x.y.z/compose
Compose mappen indeholder 5 undermapper:
| Mappe | Indhold |
|---|---|
| configuration | Her ligger alle de konfigurationsfiler som det forventes af driften tilretter til det anvendte miljø. Er delt op i 3 undermapper consumer lookup registration, Her laves konfigugration til Minlog2 Registrering |
| database | Her ville alle de databasefiler som det forventes at driften lægger på en NSP database ligge, hvis der var nogen |
| development | Her ligger en Docker Compose fil til brug for udvikling. Se Guide til Udviklere. |
| test | Her ligger en Docker Compose fil der kan starte Minlog2 i en standalone test konfiguration. |
| release | Her ligger den Docker Compose fil som det forventes driften anvender på både test og produktionsmiljøerne. |
4. Konfiguration
I mappenhttps://svn.nspop.dk/svn/components/minlog/trunk/compose/configuration/registration findes følgende konfigurationsfiler:
| Fil | Indhold |
|---|---|
| minlog2/minlog2-register.properties | Konfiguration af Minlog2 Registrering servicen |
| log4j/log4j.properties | Log opsætning af Minlog2 Registrering 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 er en beskrivelse afminlog2/minlog2-register.properties .
...
Applikations properties
Opret folder
<Jboss>/standalone/configuration/minlog2/
...
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.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 |
producer.pool.count | Antal objekter i Kafka Producer poolen. |
Konfigurationsfiler
Det er muligt at danne konfigurationsfiler svarende til et bestemt miljø fra maven.
...
Afvikling
Minlog2 Registrering startes og stoppes med Docker Compose kommandoer.
Standalone test
For en standalone test af Minlog2 Registrering hentes "compose" mappen for den ønskede version med Subversion og kommandoen "docker-compose up" køres i folderen "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".
Deployment
Deployment af applikationerne via:
...
Registrering applikation
...
Kontrol
Installationen kan kontrolleres ved at kalde den indbyggede monitor del i de enkelte løsninger:
...