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 har brug for, at MySQL driveren er installeret og tilgængelig i Wildfly. Denne vil blive brugt i forbindelse med indsættelse af de indlæste enheder.
Importeren selv leveres som en .war fil, og skal lægges ind under deployments/ mappen. Dernæst vil Wildfly starte importeren op. Sørg for at alle konfigurations filerne er de forventede steder, samt at de er korrekt udfyldt, på forhånd.
Konfigurering af leverance
Importeren bruger seks konfigurations filer, som alle findes i resource/ mappen i roden af servicens mappe på SVN. Nedenstående tabel indeholder konfigurations filerne, samt deres forventede installations mappe i Wildfly.
| Fil | Installations lokation |
|---|---|
config.properties | modules/system/layers/base/sdm4/config/sor2importer/main/ |
log4j.properties | modules/system/layers/base/sdm4/config/sor2importer/main/ |
log4j-nspslalog.properties | modules/system/layers/base/sdm4/config/sor2importer/main/ |
module.xml | modules/system/layers/base/sdm4/config/sor2importer/main/ |
nspslalog-sor2importer.properties | modules/system/layers/base/sdm4/config/sor2importer/main/ |
sdm-ds.xml | standalone/deployments/ |
log4j.properties
Leverancen benytter Apache Log4J til applikations logning, og denne fil er konfigurering af denne.
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 kommentare til disse. Alle værdier skal være udfyldt for at importeren kan fungerer korrekt.
| Navn | Standard værdi | Kommentar |
|---|---|---|
spooler.max.days.between.runs | 7 | Maks antal dage imellem hver kørsel af importeren, før at den regnes for at være forsinket |
jdbc.JNDIName | java:/SDMDS | JNDI navn på datasourcen for Stamdata Kopi Register Service databasen |
sdm.dataDir | ${jboss.server.data.dir}/sdm4 | Sti til hvor at importeren kan finde data der skal importeres |
| transaction.chunksize | 10000 | Når en datafils navn starter med transactional, bliver data læst ind i mindre transaktioner. Denne variabel angiver, hvor mange opdateringer, der foretages i hver transaktion. |
| clean.db.enabled | false | Når denne variabel er sat til true, og en datafils navn starter med cleandb, bliver alle rækker i tabellerne: SOR2SorEntity, SOR2EanLocationCode, SOR2EanLocationCodeEdiType, SOR2EdiTypes, SOR2GeoLocalisation, SOR2SorClassifications, SOR2SorReplacedByEntities og SOR2SorShakMap slettet. |
sdm-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 automatik bliver oprettet ved første kørsel.
Præliminær smoketest
https://localhost/ 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 igen fejl er sket i loggen under opstart, så kan applikationen hurtigt afprøves ved at gå ind på:
https://localhost/sor2importer/status
Dette burde give et output der ligner følgende:
OK Last import: Never run
Og HTTP status kode bør desuden også være 200 for det kald.