Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Navitabs
rootLPR 3 Indlæser - Leverancebeskrivelse
includeroottrue

...


Indledning

Dette dokument beskriver installation og konfiguration af Lpr3Indlæseren. 

...

Servicen konfigureres med 1 datasource, som tilgår databaserne vha. root brugerenen bruger med tilladelse til at skrive.

Oprettelse af database og tabeller

Datamodellen styres vha. de SQL-scripts, der findes undercsrcunder src/main/resources/db/migration.

...

Scriptene er udformet til at blive kørt med databasemigreringsværktøjet Flyway

...

I produktion anvendes scripterne manuelt og skal køres på databasen i inkrementel rækkefølge baseret på versionsnummeret i filnavnet (først V1__(...).sql, dernæst V2__(...).sql, osv.). Hvert script må aldrig køres mere end én gang.. Scriptene er designet til at kunne blive brugt i både test- og produktions-miljø.

Ved initial installation af servicen vil det således være følgende scripter, der skal køres Flyway håndtere at køre scriptene i den nedenstående rækkefølge:

Servicens database

...

korrekte rækkefølge.

Deployment

Komponenten deployes vha. NSP's platform Docker image og konfigurationsfiler mountes i containeren som angivet i projektets Compose-filer.

...

Alle konfigurerbare properties bør gennemgås inden idriftsættelse, men standardværdierne er tiltænkt anvendelse i produktion medmindre andet er angivet.

Konfiguration

Herunder beskrives de properties der findes i lpr3indlaeser-komponentens konfigurationsfiler.

lpr3.properties

Property

Beskrivelse

Default

datasource.jndi

Angiver navnet på den datasource der er konfigureret på Wildfly'en.

java:jboss/datasources/lpr3

failIfNotRunInNumberOfDays

Hvis der ikke er blevet indlæst data i det antal dage der står i denne property, så melder servicen en statusfejl.

2

persist.batch.enabled

Hvis denne property har værdien "true", så persisteres data i batches. Ellers persisteres de enkeltvis.truebatchSize

percentageOfLinesAllowedToFailValidation

Property, der angiver, hvor mange procent af linjerne i en fil, der må være fejlbehæftede, før hele indlæsningen af filen skal fejle

0 (der må ikke være fejllinjer)
lpr3BatchSizeHvis data persisteres i databasen i batches, så kan størrelsen på disse angives i denne property.10000
batchTimeout
lpr3BatchTimeoutAngiver tiden i millisekunder for hvornår en Camel aggregering har været inaktiv - og dermed er færdig.500
lpr3SecondsBetweenLogAngiver det antal sekunder der er imellem hver log-output når data persisteres.30
input_camelUrlAngiver det Camel udtryk hvor input-filerne kan hentes
.*)ekstern_camelUrlDen indlæste fil bliver indlæst i en database og den leveres også til en ekstern sftp-server
.
Her man angive det Camel udtryk hvor filen skal leveres.
*
*
)


De to Camel udtryk er meget lange så defaultværdierne står her:

*) sftp:foo@lpr3sftp:22/dxc?password=pass&readLock=changed&readLockCheckInterval=10000&antInclude=*.csv&delete=true&disconnect=true&localWorkDirectory=/tmp/lpr3&stepwise=false&initialDelay=5s&delay=5s&knownHostsFile=/pack/wildfly8/modules/dk/nsp/indlaeser/lpr3/known_hosts**)  sftp:bar@lpr3sftp:22/ekstern?password=pass&tempFileName=${file:name.noext}.tmp&knownHostsFile=/pack/wildfly8/modules/dk/nsp/indlaeser/lpr3/known_hosts

Placering af filer

Se Placering af filer beskrevet i driftsvejledningen.