Changelog
Dato | Version | Ændring |
---|---|---|
31/12-2016 | 1.0.0 | Initiel release af Dynamisk Testdata Generator |
03/03-2017 | 1.0.1 | Web interface tilføjet |
23/03-2017 | 1.0.2 | Environment 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-2021 | 1.1.0 | Opdateret 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 lockfile samt batchsize-angivelse. |
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. |
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
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. 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.
3. Monitorering
3.1. Webservice
Webservicen udstiller et overvågningsendpoint som angivet i Husreglerne. Følgende url kan anvendes:
http://nsp-host:9080/dtg-webservice/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.