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


1. 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:

1.1. 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.xml Opsætning af log-niveau og -destination. Følger NSP-standard.

1.2. Webservice

Konfigurationsfil

Beskrivelse
dtg-ds.xml Definition af datasource.
sces.xml Opsætning af CPR-opslags-klient
log4j-dtg.xml Opsæ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

1.3. CPR Cleanup

Konfigurationsfil Beskrivelse
cpr-cleanup.properties Opsætning af SRFS CPR opslagsklient, output stier samt default batch størrelse
dtg-ds.xml Datasource opsætning
log4j-dtg.xml Opsætning af log-niveau og -destination. Følger NSP standard 

1.4. Swagger

Konfigurationsfil Beskrivelse
swagger.yml Bruges af swagger-containeren til at generere en API-specifikation af DTG'en

2. Kørsel

2.1. 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.

2.2. 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

2.3. Swagger

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

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

3. Monitorering

3.1. Webservice

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


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

3.2. CPR Cleanup

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

     http://nsp-host:port/dtg-cpr-cleanup/status

4. Database

DTG databasen indeholder 3 tabeller:

Tabel Indhold
Event En række per event som er modtaget gennem Webservicen eller migreret via Bootstrap processen.
RandomValues Et større antal default værdier for event felter som Webservicen bruger hvis en anvender ikke angiver nogen værdi.
GeneratorRevision Generatorens 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.

  • No labels