Page History
| Navitabs | ||||||
|---|---|---|---|---|---|---|
| ||||||
Indhold
| Table of Contents |
|---|
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 Docker, WildFly applikation server, Kafka og java.
...
Definitioner og forkortelser
VersionDefinition | 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.
...
Registrering
applikations-, SLA- og auditlog
...
NSP | Den nationale service platform (inden for sundheds-IT) |
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 mappenhttps://svn.nspop.dk/svn/components/minlog/trunk/compose.
For release x.y.z af Minlog2 Registrering findes Docker Compose filerne i mappenhttps://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 ligger databasefiler som det forventes at driften lægger på en NSP database |
| 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. |
Database
Der er kommet en ny tabel ifm. SDS-7688 til whitelisting. Den skal oprettes første gang whitelisting sættes i drift. Script til dette findes i git repository under:
compose/database/07_whitelisting.sqlKonfiguration
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.
Konfiguration
Nedenstående er en beskrivelse afminlog2/minlog2-register.properties .
...
- 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 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 | kafka.producer.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.
...
producer.pool.count | Antal objekter i Kafka Producer poolen. |
parentalCustody.age.limit=15 | Aldersgrænse for hvornår en borger ikke længere kan claime forældremyndighed på et barn |
audience=https://minlog | Minlogs audience streng |
powerofattorney.privileges=urn:dk:nspop:sts:minlog2:read | Tilladte fuldmagtsstrenge. Hvis flere adskilles de af komma. Eksempel: urn:dk:nspop:sts:minlog2:read,urn:dk:nspop:sts:minlog:read |
whitelisting.cache.ttl=PT1M | Time To Live for Whitelisting-cachen. Default 1 min. |
minlog2.endpoint.register=http://localhost:8080/minlog2-registration | Endpoint som bruges af DKS at angive service url, som bruges af DCC. |
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 mappen "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:
...