Versions Compared

Old Version 6

changes.mady.by.user Jesper André Grønkjær Lyngesen Pedersen

Saved on

compared with

New Version 7

changes.mady.by.user Jesper André Grønkjær Lyngesen Pedersen

Saved on

Key

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

...

Numbered Headings

Konfiguration

Konfiguration sker i filerne i compose/configuration-mappen, følger den normale komponent-standard og består af følgende filer, der volume-mappes ind:

Generator

Konfigurationsfil

Beskrivelse

generator.properties

Opsætning af datasource, directorystier til importere og indlæsere, og lockfile samt batchsize-angivelse.


Generering til de enkelte importere/indlæsere kan tændes/slukkes vha. *.enabled-flag (hvor * er navnet på importeren/indlæseren).

log4j-dtg-generator.xmlOpsætning af log-niveau og -destination. Følger NSP-standard.

Webservice

Konfigurationsfil

Beskrivelse

dtg-ds.xmlDefinition af datasource.
sces.xmlOpsætning af CPR-opslags-klient
log4j-dtg.xmlOpsætning af log-niveau og -destination. Følger NSP-standard.

Ud over denne konfiguration, skal brugernavne og kodeord til Webservicen styres gennem Wildflys brugerstyring.

  • Brugere skal være tilknyttet ApplicationRealm / af typen Application User (default application-users.properties filen)
  • Brugernavne skal matche Ejer kolonnen i Event tabellen
  • Brugere skal være tilknyttet gruppen dtg (default application-roles.properties filen)

Én måde at tilføje brugere på, er at udføre følgende kommando mod docker-containeren med alle <>-sektioner erstattet: 

$ docker exec -ti <dtg-container-name> /pack/wildfly/bin/add-user.sh -a --realm ApplicationRealm --user "<username>" --password "<password>" --enable --group dtg

CPR Cleanup

KonfigurationsfilBeskrivelse
cpr-cleanup.propertiesOpsætning af SRFS CPR opslagsklient, output stier samt default batch størrelse
dtg-ds.xmlDatasource opsætning
log4j-dtg.xmlOpsætning af log-niveau og -destination. Følger NSP standard 

Kørsel

Generator

Generator-containeren er en one-shot container, der laver sit arbejde een gang og lukker ned.

Generatoren laver et enkelt gennemløb af nye events i DTG databasen og genererer en eller flere filer pr. importer/indlæser. Generatoren skal derfor startes med et Cron job så det kører med faste intervaller.
Der må aldrig være 2 instanser af Generatoren der kører samtidigt, dette skal sikres i driftopsætningen.
Generatoren bør manuelt køres en enkelt gang efter Bootstrap processen har kørt, da denne kørsel vil tage betragteligt længere tid end normale kørsler.
Når events fra Bootstrap processen er blevet bearbejdet af den manuelle kørsel af Generatoren, vil et fornuftigt interval for Generatoren være en gang i timen.

Monitorering

Webservice

Webservicen udstiller et overvågningsendpoint som angivet i Husreglerne. Følgende url kan anvendes:


	http://nsp-host:9080/dtg-webservice/status

Database

DTG databasen indeholder 3 tabeller:

TabelIndhold
EventEn række per event som er modtaget gennem Webservicen eller migreret via Bootstrap processen.
RandomValuesEt større antal default værdier for event felter som Webservicen bruger hvis en anvender ikke angiver nogen værdi.
GeneratorRevisionGeneratorens tidsstempel og revisionsnummer samt miljø for seneste håndtering af hver Event type.

Alle events der oprettes i DTG databasen knyttes til en ejer med kolonnen Event.Ejer, når en bruger logger ind i Webservicen med HTTP Basic Auth, så ser de kun de events der har brugernavnet i Ejer kolonnen. Hvis et ejernavn ender med strengen "-bootstrapped" så kan det tilsvarende brugernavn ikke anvende den indbyggede klient, de skal derimod selv kalde Webservicens endpoints for at liste og oprette data.