1. Indhold
2. Indledning
Minlog2 leveres som et projekt bestående af 2 webservice løsninger.
Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til Docker, WildFly applikation server, Kafka og java.
2.1. Dokumenthistorik
Version | Dato | Ansvarlig | Beskrivelse |
1.8 | 09-03-2021 | KvalitetsIT | Ændret til docker setup |
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 |
2.2. Definitioner og forkortelser
Definition | Beskrivelse |
NSP | Den nationale service platform (inden for sundheds-IT) |
3. Installation
3.1. Docker
Minlog2 Registrering består af et Docker images som pushes til NSP Docker Registry under navnet:
registration
3.2. Docker Compose
Minlog2 Registrering leveres samtidig som et sæt af Docker Compose filer i mappen https://svn.nspop.dk/svn/components/minlog/trunk/compose.
For release x.y.z af Minlog2 Registrering findes Docker Compose filerne i mappen 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 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. |
4. 4. Konfiguration
I mappen https://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.
4.1. Tilføjelser
Nedenstående er en beskrivelse afminlog2/minlog2-register.properties .
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. |
5. Afvikling
Minlog2 Registrering startes og stoppes med Docker Compose kommandoer.
6. 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".
7. 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".
8. 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.