Page History
| Navitabs | ||||
|---|---|---|---|---|
| ||||
| Table of Contents | ||
|---|---|---|
|
Indledning
Dette dokument beskriver installation og konfiguration af Sikrede Indlæser.
...
NSP Leverandøren er selv ansvarlige for at pushe release versioner af Sikrede Indlæser til NSP Docker Registry gennem Jenkins. (TBD: også med git?)
Docker
Sikrede Indlæser består af følgende Docker image som pushes til NSP Docker Registry:
Docker Compose
Sikrede Indlæser leveres samtidig som et sæt af Docker Compose filer i folderen compose.
...
Compose folderen indeholder 5 underfoldere:
| configuration | Her ligger alle de konfigurationsfiler som det forventes af driften tilretter til det anvendte miljø. |
| development | Her ligger en Docker Compose fil til brug for udvikling. Se Guide til Udviklere. |
| test | Her ligger en Docker Compose fil der kan starte Sikrede Indlæser i en standalone test konfiguration. |
| release | Her ligger den Docker Compose fil som det forventes driften anvender på både test og produktionsmiljøerne. |
Krav til miljø
Krav til applikationsservere
...
Herunder beskrives de properties der findes i Sikrede Indlæsers konfigurationsfiler.
sikr.properties
| sikr.app.name | Kortnavnet på Sikrede Indlæser | SIKR |
| input.folder | Den interne folder, hvor data, der hentes fra kilden placeres til processering af Sikrede Indlæser | /tmp/sikrede/input |
| backup.folder | Angiver placering af backup fil. Dette skal være en folder internt i den Docker container der kører |
Sikrede indlæseren. For at have adgang til de backup'ede filer efter Docker containeren er slukket, skal der laves en volume-mount af en ekstern folder ind til den angivne folder i Docker containeren. | /tmp/sikrede/input/.done | |
datasource.sikr.jndi.name | Angiver navnet på den datasource der er konfigureret på Wildfly'en. | java:/SIKRDS |
ekstern_camelUrl Denne konfiguration er udelukkende til brug for Sikrede Indlæser og er således ikke en generisk funktionalitet i indlæser reference arkitekturen | Data fra den indlæste fil bliver indlæst i en database. Det er muligt at få indholdet af den indlæste fil leveret til en ekstern SFTP-server, og dette Camel udtryk angiver hvordan filen skal leveres. Hvis ekstern_camelUrl ikke har en værdi, vil der ikke blive foretaget en ekstern levering. | **) |
| input_camelUrl | Angiver det Camel udtryk der henter input-filerne fra SFTP serveren. De filer der hentes lægges i en intern folder i Docker containeren. Den interne folder der hentes til er /tmp/sikrede/input For at have adgang til de hentede filer efter Docker containeren er slukket, skal der laves en volume-mount af en ekstern folder ind til den angivne folder i Docker containeren. | *) |
Denne figur viser hvor de properties der styrer Yderindlæserens Sikrede indlæserens opførsel har indflydelse.
TODOTBD:
- Sikrede Indlæser henter filer ind fra SFTP serveren som angivet i input_camelUrl
- Sikrede Indlæser laver backup af behandlede filer som angivet i backupType og backupFolder
- Hvis der er angivet en ekstern_camelUrl foretages der en eksterne levering af den modtagne fil
- Sikrede Indlæser anvender datasource udpeget af datasource.sikr.jndi.name til at tilgå databasen
- Property batchSize og batchTimeout anvendes i Sikrede Indlæser til at styre validering af den modtagen fil og batch-håndtering mod databasen.
- Den interne læsning af de hentede filer, der er angiver i figuren med intern-camelUrl er ikke konfigurerbar. Den har den faste værdi
file:/tmp/ydersikrede/input?readLock=fileLock&antInclude=*.txt&delete=true&sortBy=file:name
som angiver at den indlæser filer med endelsen txt som ligger i folderen /tmp/sikrede/input.
...
*) sftp:foo@sikredesftp:22/praksys?password=pass&readLock=rename&antInclude=*.txt&delete=true&disconnect=true&stepwise=false&initialDelay=5s&delay=5s&knownHostsFile=/pack/wildfly8wildfly/modules/dknsp/nsisikr/sdm/yder/known_hosts
**) sftp:bar@sikredesftp:22/ekstern?password=pass&tempFileName=${file:name.noext}.tmp&knownHostsFile=/pack/wildfly8wildfly/modules/dk/nsi/sdm/ydernsp/sikr/known_hosts
Alle filer skal tilrettes til de forskellige miljøer som Sikrede Indlæser installeres på. Filerne indeholder en konfiguration der passer til Sikrede Indlæser i en standalone test konfiguration.
...