Projektspace for Arosii / Home / Dynamisk Testdata Generator Installationsvejledning
Created by Jacob Qvortrup, last modified by Unknown User (mxj) on 23-03-2017
Changelog
Dato |
Version |
Ændringer |
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. |
Indhold
Dynamisk Testdata Generator består af 3 selvstændige dele. En bootstrapper som migrerer eksisterende testdata fra en Stamdata database til DTG databasen, en Webservice som modtager forespørgsler fra en klient og fra scripts som anvendere selv kan udvikle, samt en Generator der med faste intervaller leverer inputfiler til stamdataimporterne baseret på data i DTG databasen. Se Design og Arkitekturbeskrivelse for en gennemgang af hvilke databaser, der er en del af løsningen.
Projektet bygges med Maven 3 og herefter er følgende 3 artefakter tilgængelige:
{project.base}/modules/bootstrap/target/dtg-bootstrap-jar-with-dependencies.jar
{project.base}/modules/generator/target/dtg-generator-jar-with-dependencies.jar
{project.base}/modules/webservice/target/dtg-webservice.war
I de følgende filer er der eksempler på konfigurationen af Webservicen:
{project.base}/modules/webservice/etc/dtg/config.xml
{project.base}/modules/webservice/etc/dtg/endpoints.xml
{project.base}/modules/webservice/etc/dtg/sces.xml
{project.base}/modules/webservice/etc/dtg/services.xml
{project.base}/modules/webservice/etc/dtg-ds.xml
{project.base}/modules/webservice/etc/log4j-dtg.xml
I den følgende fil er der eksempler på konfigurationen af Boostrapper:
{project.base}/modules/bootstrap/etc/bootstrap.properties
I de følgende filer er der eksempler på konfigurationen af Generator:
{project.base}/modules/generator/etc/generator.properties
{project.base}/modules/generator/etc/log4j-dtg-generator.xml
Derudover findes der følgende filer til oprettelse af den nye DTG database:
{project.base}/modules/common/etc/create_dtg_db.sql
{project.base}/modules/webservice/etc/create_random_values.sql
1 of 214/07/2017, 10.28 Installationsvejledning - Projektspace for Arosii -https://www.nspop.dk/display/arosii/Installationsvejledning
Filen create_dtg_db.sql tilrettes med de valgte credentials og køres herefter på den MariaDB instance som skal anvendes. Herefter køres filen create_random_values.sql, som opretter de default værdier webservicen bruger, hvis en anvender ikke angiver en værdi for et felt. Ved kørsel af begge filer er det vigtigt, at der angives default charset til utf-8 ved f.eks. at køre filerne på følgende måde:
mysql --default-character-set=utf8 dtg < create_random_values.sql
Filen dtg-bootstrap-jar-with-dependencies.jar kopieres til et tomt arbejdsbibliotek sammen med en tilrettet version af filen bootstrap.properties.
Konfiguration af databaseadgang foretages i filen bootstrap.properties som for hver af de 3 databaser indeholder følgende properties:
url - Den fulde jdbc url der skal bruges for at forbinde til databasen. user - Brugernavnet til at forbinde til databasen. password - Kodeordet til at forbinde til databasen. name - navnet på selve databasen
Bootstrap koden laver join på tværs af E-SDM og BST databaserne så de to brugere til disse databaser skal have rettighed til at slå op i de andre databaser.
Biblioteket {project.base}/modules/webservice/etc/dtg kopieres ind i {Wildfly.base}/standalone/configuration/.
Filen log4j-dtg.xml kopieres ligeledes ind i {Wildfly.base}/standalone/configuration/.
Filen dtg-ds.xml kopieres ind i {Wildfly.base}/standalone/deployments/ og rettes til med passende credentials mv.
I filen sces.xml tilrettes der så federation angives til productionFederation, ligeledes ændres konfigurationen af sces beanen med et produktions-certifikat og produktions-endpoints. Den testdata løsning som DTG erstatter har i forvejen et produktionscertifikat mv. som kan anvendes her.
De to filer javax.json-1.0.4.jar og module.xml i biblioteket {project.base}/modules/webservice/etc/json-1.0.4 kopieres ind i {Wildfly.base}/modules/system/layers/base/org/glassfish/javax/json/1.0.4.
Til sidst placeres filen dtg-webservice.war i {Wildfly.base}/standalone/deployments/ og webservicen er nu klar til brug
Filen dtg-generator-jar-with-dependencies.jar kopieres til et tomt arbejdsbibliotek sammen med en tilrettet version af filen generator.properties.
Generatoren leverer filer til CPR2Importeren, SikreddeImporteren, AutorisationsImporteren og YderImporteren, så disse skal være tilgængelige på samme miljø
Konfiguration af Generatoren foretages i filen generator.properties som indeholder følgende properties:
database.dtg.url - Den fulde jdbc url der skal bruges for at forbinde til databasen. database.dtg.user - Brugernavnet til at forbinde til databasen. database.dtg.password - Kodeordet til at forbinde til databasen.
*.importerDirectory - Stien til der hvor Generatoren skal levere data til Importeren (hvor * indikerer navnet på importeren).
generator.environment - Miljøangivelse som generatoren bruger til revisionsstyring. generator.tempDirectory - Stien til placering af temporært bibliotek for generator-filer. generator.lockFileDir - Stien til lock-filens placering.
cpr2importer.batchsize - antal records, der behandles i samme transaktion mod cpr2importeren og sikredeimporteren. log4j.configuration - Stien til log4j konfigurationsfilen.