Introduktion og overblik
Driftvejledningen indeholder information, som er relevant i forhold til drift af eCPR. Der gives en grundig introduktion til konfiguration, herunder hvilke properties der eksistere, samt deres standard konfiguration. Dertil kommer information om hvordan systemet overvåges i form af HTTP-endpoints samt Auditlog, SLA-logning samt øvrig logning.
eCPR består af én javabaseret web-service, nemlig eCPR-service. servicen har følgende afhængiheder:
- Der kræves adgang til en MariaDB datasource
- National adviserings service 2.0 (NAS)
- Kald til (læsning fra) CPR-Enkeltopslag (SCES)
- Læsning fra krs-stamdata gennem et view.
Dokument historik
Version | Dato | Ændring | Ansvarlig |
---|---|---|---|
0.1 | 23.10.2023 | Påbegyndt driftvejledningen | Trifork |
1.0 | -- | Initialt dokument | Trifork |
Konfiguration
Konfigurationen af eCPR sker i filerne i "compose/configuration" mappen som beskrevet i installationsvejledningen. I det følgende gennemgås hver enkelt services konfigurationsfiler i detaljer:
Konfiguration af eCPR-servicen
Overordnet konfiguration | Property | Beskrivelse |
---|---|---|
Database | spring.datasource.* | Dette er 4 properties der bruges til at konfigruere databasen, herunder driver class name, url, username og password |
Dcc | dcc.endpoint | Dette er adressen til eCPR udstillet til dcc'en |
Schema validering
| schemavalidation.validate.* | Boolean der angivre om request og/eller respons skal skemavalideres |
schemavalidation.fail.on.response.error | Angiver om der skal smides en fejl hvis responset ikke overholder skemaet (er skemavalid) | |
Lucene indexering
| jobs.searchindex.maxResut | Max antallet af resultater som lucene søgning kan returnere |
jobs.searchindex.enabled | Angiver om lucene indexeringsjobbet skal køre. Skal som udgangspunkt altid være enabled, for ellers forældes data i lucene indexet hurtigt. | |
jobs.searchindex.msInitialDelay | Angiver tiden fra start af deployment til første Lucene Indexerings kørsel | |
jobs.searchindex.msDelayBetween | Angiver hvor ofte lucene indexeringsjobbet skal køre | |
jobs.searchindex.InitialLoad.batchSize | Når opstarts indexeringen køres, angiver batchSize antallet af linjer, altså maximal datamængde, der indlæses ad gangen | |
jobs.searchindex.InitialLoad.msBetweenBatches | tiden mellem batches | |
jobs.searchindex.alwaysIndexFullDatabase | Angiver om alt data i databasen skal indexeres ved kørsel af lucene indexing | |
Slet reserverede eCPR-numre
| jobs.deletedReservedIDs.enabled | Hvis der reserveres en række eCPR-numre, så sættes der en udløbsdato på disse cpr-numre. Hvis ikke der er indlæst data inden udløbsdatoen er overskredet angiver denne property, om de reserverede eCPR-numre skal slettes |
jobs.deletedReservedIDs.executeEachMidnight | ??? | |
Export history to file
| jobs.exportHistoryToFile.enabled | Angiver om export jobbet skal køre. Dette angiver altså ikke kun om export jobbet skal gemmes til en fil, men om exportHistory jobbet skal køre i det hele taget |
jobs.exportHistoryToFile.initialDelay | Angiver tiden fra start af deployment til første exportHistory-job køres | |
jobs.exportHistoryToFile.delayBetween | Angiver tiden mellem to på hinanden følgende exportHistory jobs | |
jobs.exportHistoryToFile.initialLoad.batchSize | Når første exportHistory-job køres, angiver batchSize antallet af linjer, altså maximal datamængde, der indlæses ad gangen | |
jobs.exportHistoryToFile.initialLoad.msBeweenBatches | tiden mellem batches | |
temp.dir | temp.dir bliver brugt til at lagre midlerdigige exportHistory filer før de bliver zippet. Bør forblive den angivne fil. | |
ziptemp.dir | ziptemp.dir er en undermappe til temp.dir hvor zipfilen placeres inden den sendes | |
completedFileName | Navnet på zip-filen | |
temp.archive.dir | Denne fillokation er en undermappe til temp.dir, hvor zipfilen arkiveres efter den er sendt. | |
sftp.remote.dir | SKAL SLETTES | |
Upload zip-file to NSP-job | jobs.uploadToNsp.* | Dette er tilsammen 3 properties, der konfigruerer hvorvidt exportHistory.zip-filen skal uploades til NSP samt initial delay og tiden mellem 2 jobs. |
sftp.enabled | ANgiver om sftp-funktionaliteten af jobbet er aktiveret. Hvis denne er disabled sendes exportHistory.zip-filen ikke til nsp uanset konfigurationen af jobs.uploadToNsp. | |
| sftp.remote.path | Denne fil angiver hvor på modtagerserveren zip-filen skal placeres |
| sftp.hostname | |
| sftp.port | |
| sftp.username | |
| sftp.password | |
Logginglevel | logging.level.org.springframework.web | Spørg Jakob |
| logging.level.org.springframework.security | Spørg Jakob |
admin.service.shouldCheckPermissions | Propertien angiver, om der skal tjekkes, at brugere har de nødvendige rettigheder for at udføre det pågælende kald der er udført. | |
| spring.datasource.tomcat.connection-properties | Spørg Jakob |
Advis forwarding
| advis.enabled | Angiver om advisering til NAS er enabled |
nas.url | Angiver den endelige url til NAS | |
|
| |
| isProduction | Denne bool angiver om systemet er i produktion. |
| kafka.producer.fmk.server=kafka:9092 |
Konfiguration af log4j2-ecpr2
OBS!! vent med at opdatere til log4j er degraderet til log4j2
Her skal ske en detaljeret beskrivelse af konfiguraionsfilerne. OBS! Husk at lav et link hertil fra installationsvejledningen!
Overvågning
Http Endpoints
Health status side (isAlive)
exportHistory
Logning
3.2.1 Auditlog
3.2.2 SLA logning
3.2.3 Intern logning