Versions Compared

Old Version 14

changes.mady.by.user Unknown User (ani)

Saved on

compared with

New Version 15

changes.mady.by.user Unknown User (ani)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 MariaDB som skal indeholde databasen "stamdata"Kafka.

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

Dokumenthistorik

Version

Dato

Ansvarlig

Beskrivelse

1.704-06-2019OpenmindsYderligere specifikation af installationer
1.620-09-2018OpenmindsYderligere 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


...

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. Se konfigurationsfiler.
  • nspslalog-minlog2.properties

Disse 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-minlog2.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 kommuner.json indlæses når applikationen starter. Filen er hentet fra dawa.aws.dk (i skrivende stund: http://dawa.aws.dk/kommuner).
    Filen minlog2-register.properties flyttes til ovenstående folder.

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

    PropertyBeskrivelse
    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

    ...

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


    ├── 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
    ├── minlog2
       └── kommuner.json
       └── minlog2-register.properties

    Database

    Der er udarbejdet sql-filer til blandt andet oprettelse af minlog2 skema – find dem i <project>/code/jee/shared/shared-configuration/src/main/resources/sql.

    Systemet kræver initial_schema.sql.

    De øvrige filer i denne folder er ment som en hjælp til test og udvikling. De skal således ikke køres i produktion.

    Skemaer

    Der skal være adgang til følgende MariaDB skemaer:

    • MinLog2 (oprettes i Database)
    • Stamdata (skal findes i forvejen)

    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:

    ...