Anchor
_Toc250887291 _Toc250887291

Formål

...

Den primære målgruppe for dokumentet er systemudviklere.

Anchor
_Toc263424147 _Toc263424147

Anchor
_Toc250887294 _Toc250887294

System design

Stamdata importerne består af en kerne komponent (sdm4-core), og en række importer specifikke komponenter – alle deployes på Dodi'en og har udelukkende til formål at populere data i en database (kan godt være forskellige databaser for hver komponent), se \[DESIGN\] for yderligere information vedrørende DoDi.
\\
*Komponenter på DoDi:*
DoDi applikationerne er en række selvstændigt kørende applikationer, til overvågning af indkomne data filer, der kan være i forskellige formater (XML, fastlængde, csv, m.v). Indkomne filer indlæses, valideres og gemmes herefter i DoDi'ens database.
\\
Hvert komponent indeholder en implementation af et Parser interface der fungerer som entry-point til applikationen. Det anbefales, at man som ny udvikler på projektet kigger koden igennem med denne fil som udgangspunkt.

Anchor
_Toc250887295 _Toc250887295

Properties

...

Opsætningen af udviklingsmiljøet for stamdataservicen forudsætter, at følgende elementer allerede er installeret på udviklerens maskine:

• Java Developer Kit 6.0_x
• Et passende udviklingsmiljø
• Maven 3.x
• Virtualbox version 4.1.18
• Vagrant version 1.0.3
• MySQL database 5.1.x
• JBoss AS7 (bliver sat op via Puppet scripts)

...

Anchor
_Toc250887299 _Toc250887299

Byggemiljø

Stamdataprojektet anvender Maven som byggesystem \[MAVEN\]. Strukturen følger de generelle anbefalinger for Maven projekter, og er struktureret med en parent pom.xml og en projekt pom.xml fil for hvert underprojekt.
Subprojekterne er opbygget efter Maven layout konventionen.
\\
For at bygge en importer, skal man gøre følgende:
Check Core-modul ud og kør mvn install
Check Maven-plugin ud og kør mvn install
CheckTest-utils ud og kør mvn install
Check parent-modul ud og kør mvn install
\\
Herefter er du klar til at bygge et importer-modul.
Importmodulets integrationstest er afhængig af at ligge som et subdirectory til parent-modulet, så du skal checke det ud som sådan et.
Hvis du ønsker at checke alle importermoduler ud, ligger der i roden af parent-modulet et script, checkout-importermodules.sh, som udfører checkout af alle importermoduler samt maven-plugin og test-utils.
\\

Anchor
_Toc250887300 _Toc250887300

Dependencies

...

DoDi-projekterne anvender Vagrant+Puppet til at opsætte udviklingsmiljøet.
For at få bootet og opsat en udviklingsmaskine, køres følgende
% vagrant up
Fra roden af et importermodul eller fra parent-modulet.
Når vagrant har bygget den virtuelle maskine, er den sat op med den korrekte version af JBoss 7 samt en MySQL der er konfigureret til at have en root-bruger med password papkasse og en sdm4-bruger med password sdm4.
Der er også automatisk oprettet en tom database med standard-navnet for databasen, (sdm_warehouse) og en datasource i JBoss med det JNDI-navn, som applikationen som default forventer at kunne slå datasource op.
Applikationen kører ved opstart automatisk databaseskema på databasen.
Der er forwardet følgende porte ind i den virtuelle maskine, så man kan tilgå jboss og mysql fra sin lokale maskine
8080 -> 8080 (dvs. at man kan tilgå http://localhost:8080/)
3307 -> 3306 (dvs. at man kan have en urelateret mysql kørende lokalt og tilgå SDM-mysql'en på den virtuelle maskine på url localhost:3307)

Anchor
_Toc250887303 _Toc250887303

Test

...

I de følgende beskrives problemer og deres løsninger:

Anchor
_Toc250887309 _Toc250887309

JBoss out of memory

...

Nyeste udgave af dette dokument kan erhverves ved henvendelse til NSP-operatøren.

Anchor
_Toc310537059 _Toc310537059

Anchor
_Toc250887313 _Toc250887313

Referencer og kilder