Konfiguration

Bootstrap

Ud over databaseopsætning som er gennemgået i Installationsvejledningen er det muligt at tilføje følgende konfigurationer:

Generator

Ud over database- og importer-opsætning som er gennemgået i Installationsvejledningen er det muligt at ændre følgende konfigurationer:

Webservice

Ud over standard Log4J konfiguration i filen log4j-dtg.xml skal der styres brugernavne og kodeord til Webservicen 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 bruge scriptet {Wildfly.base}/bin/add-user.sh

Kørsel

Bootstrap

For at starte Bootstrap processen køres følgende kommando i det bibliotek som filerne dtg-bootstrap-jar-with-dependencies.jar og bootstrap.properties er placeret i:

	java -Dconfiguration=bootstrap.properties -jar dtg-bootstrap-jar-with-dependencies.jar

Bootstrap processen skal startes manuelt og kun køres en enkelt gang.

Når Bootstrap processen er gennemført, kan der laves en liste over brugere/ejere ved at udtrække alle unikke værdier fra Owner-feltet i Event-tabellen. Udfra denne liste kan der tildeles adgang til systemet for de ejere, for hvem det måtte være relevant. Ejere der har mere end 1000 CPR-numre tilknyttet i bestillingsdatabasen, får deres CPR-numre delt op på flere ejernavne. Ejeren fmk har som eksempel næsten 50000 CPR-numre, hvorfor de første 1000 records får ejeren fmk001, de næste 1000 records får ejeren fmk002 og så fremdeles. Årsagen til denne opdeling på flere ejernavne er, at det ikke er hensigtsmæssigt at skulle indlæse helt op imod 50000 records for en enkelt ejer, når en bruger tilgår testdatasystemet via web-klienten.

Generator

For at starte Generatoren køres følgende kommando i det bibliotek som filerne dtg-generator-jar-with-dependencies.jar og generator.properties er placeret i:

	java -Dconfiguration=generator.properties -jar dtg-generator-jar-with-dependencies.jar

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.

Log

Bootstrap

Hvis ikke andet er angivet i konfigurationen så skrives log for Bootstrap processen både til standard out og til filen bootstrap.log i current working dir. Log filen skal arkiveres efter den endelige kørsel af Bootstrap processen.

Generator

Log filer skrives af generatoren ud fra den konfiguration som angives i log4j-dtg-generator.xml filen (Vær opmærksom på at ${jboss.server.log.dir} ikke kan anvendes ifm konfiguration af log filer).

Logfilerne fra Generatoren skal samles op af Splunk.

Webservice

Log filer skrives af Webservicen ud fra den konfiguration som angives i log4j-dtg.xml filen.

Logfilerne fra Webservicen skal samles op af Splunk.

Monitorering

Bootstrap

Bootstrap processen er en enkelt kørsel, der migrerer alle data fra den eksisterende stamdata database til DTG databasen, og der er derfor ingen overvågning. Log filerne skal gennemgås efter kørsel og derefter arkiveres.

Generator

Der skal laves en overvågning af at Java processen er kørende, og derudover en overvågning af at der ikke kommer Warnings eller Errors i log filerne.

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:

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.