Changelog

DatoVersionÆndring
31/12-20161.0.0Initiel release af Dynamisk Testdata Generator
03/03-20171.0.1Web interface tilføjet
23/03-20171.0.2Environment tilføjet til generator. Webservice-modul opdateret til at gøre brug af json-1.0.4 i stedet for json-1.0.3.
11/01-20211.1.0Opdateret efter skift til docker baseret håndterig

Indhold


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.
mitid-simulator.xml

Opsætning af klient til integration med Digitaliseringsstyrelsens MitID Simulator.

Pt. er den eneste konfigurationparameter hvilket endpoint servicens kan rammes på: https://mitidsimulator.test-devtest4-nemlog-in.dk/

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 

Swagger

KonfigurationsfilBeskrivelse
swagger.ymlBruges af swagger-containeren til at generere en API-specifikation af DTG'en

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.

CPR Cleanup

CPR cleanup kører ved siden af DTG i sin egen container og egen wildfly. Tjekket igangsættes ved at kalde følgende URL:

     http://nsp-host:port/dtg-webservice/cleanup

Swagger

Swagger UI kører ved siden af DTG i sin egen container og udstilles på:

     http://nsp-host:port/dtg-api/

Monitorering

Webservice

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


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

CPR Cleanup

CPR Cleanup udstiller ligeledes et overvågningsendpoint iht husreglerne. Den findes på flg. URL

     http://nsp-host:port/dtg-cpr-cleanup/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.