Indholdsfortegnelse
Opsætning, krav, og forudsætninger til platform
Importeren er udviklet under den forudsætning, at den skal køre under en Wildfly 8.2 server, og køre med Java 8. Derudover er den under den antagelse, at den skal køre i NSP backoffice.
Importeren leveres som et docker-image.
Konfigurering af leverance
Importeren bruger seks konfigurations filer, som alle findes i compose/configuration mappen i roden af servicens mappe på SVN. Nedenstående tabel indeholder konfigurationsfilerne, samt deres forventede installations mappe i Wildfly.
| Fil | Installations lokation |
|---|---|
config.properties | /pack/wildfly8/modules/sdm4/config/sebimporter/main/ |
log4j-nspslalog-sebimporter.properties | /pack/wildfly8/modules/sdm4/config/sebimporter/main/ |
log4j.properties | /pack/wildfly8/modules/sdm4/config/sebimporter/main/ |
module.xml | /pack/wildfly8/modules/sdm4/config/sebimporter/main/ |
nspslalog-sebimporter.properties | /pack/wildfly8/modules/sdm4/config/sebimporter/main/ |
stamdata-ds.xml | /pack/wildfly8/standalone/deployments/ |
log4j.properties
Leverancen benytter Apache Log4J til applikationslogning, og denne fil indeholder konfiguration af loggen.
Nærmere omkring opsætning af Log4J appenders kan findes på projektets egen dokumentations side her.
config.properties
Dette er den centrale konfigurations fil for importeren. Nedenfor er en gennemgang af alle indstillinger, og kommentarer til disse.
| Navn | Standard værdi | Kommentar |
|---|---|---|
spooler.max.days.between.runs | 12 | Maks antal dage imellem hver kørsel af importeren, før at den regnes for at være forsinket |
jdbc.JNDIName | java:jboss/datasources/SDMDS | JNDI navn på datasourcen for Stamdata Kopi Register Service databasen |
sdm.dataDir | /data/importers | Sti til hvor importeren kan finde data der skal importeres |
| spooler.sebimporter.max.allowed.reduction | 50 | Maksimal tilladt reduktion i antal aktive roller efter en kørsel af importeren. |
stamdata-ds.xml
Denne fil indeholder opsætningen af forbindelsen til Stamdata Kopi Register Service databasen på NSP. Filen bruges af Wildfly til at opsætte en forbindelse til databasen, og derved ikke af applikationen direkte. Hvis en eksisterende datasource er skrevet ind i config.properties, kan denne fil helt skippes, ellers er det vigtigt at JNDI navnene stemmer overens.
Konfigurering/Opsætning af database
Importeren har indbygget automatiseret konfigurering/opsætning af databasen. Når servicen bliver deployed i Wildfly, så checker den igennem hvilke af SQL scripts den har eksekveret ved tidligere deployments, og eksekverer dem som er nye. Den checker hvilke der er nye ud fra en tabel, som automatisk bliver oprettet ved første kørsel.
Præliminær smoketest
https://localhost:8080/ bliver i de følgende URL'er brugt som eksempel. Ret disse til så de rent faktisk passer med virkeligheden.
Når importeren er blevet startet op, og ingen fejl er sket i loggen under opstart, så kan applikationen hurtigt afprøves ved at tilgå:
https://localhost:8080/sebimporter/status
Dette skal give et output der ligner følgende:
OK Last import: Never run
Og HTTP status kode bør desuden også være 200 for kaldet.