Page History
...
Driftvejledningen indeholder information, som er relevant i forhold til drift af Nationalt eCPR (Herefter 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ængihederafhængigheder:
- 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.
...
| 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 | Disse to properties sætter logging level af springframeworket. Denne bør justeres til et lavt niveau inden eCPR sættes i produktion. Øvrige logningsniveauer er angivet i log4j konfigurationsfilen (NAVN!?log4j.properties (Se afsnit Konfiguration af log5j-ecpr2) |
logging.level.org.springframework.security | ||
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 | |
Sosi-certifikat | sosi.* | De relevandte sosi parametre er angivet sidst i propertyfilen. For at læse mere om sosi henvises til HVOR!? |
Sosi-certifikat | sosi.sts.url | Endpoint for Secure Token Service (STS) |
| sosi.careprovider.name | Firmanavn fra systemcertifikat, som anvendes til DGWS adgang til DDS registry |
| sosi.careprovider.cvr | CVR-nummer fra systemcertifikat, som anvendes til DGWS adgang til DDS registry |
| sosi.production.federation | Angiver om det certifikat, der anvendes til adgang DGWS-adgang til DDS registrym, er et produktionscertifikat |
| Systemnavn fra systemcertifikat, som anvendes til DGWS adgang til DDS registry | |
| sosi.keystore.file | Navn på keystore med det systemcertifikat, som anvendes til DGWS adgang til DDS registry (Andre steder er det .path og ikke file, men er det mon det samme?) |
| sosi.keystore.password | Password til keystore med det systemcertifikat, som anvendes til DGWS adgang til DDS registry |
| sosi.timeout | Timeout for kald til DDS, angivet i millisekunder |
| isProduction | Denne bool angiver om systemet er i produktion. |
...
Til intern logning bruges Log4J, hvor logningsniveauet er specificeret i log4J konfigurationsfilen (se ovenfor).
Hvad er logningskonventionen i eCPR? Kan det bruges til debugging, eller hvad kan det bruges til?
Fejlfinding
Servicens logfiler kan med fordel løbende tjekkes for Error-logninger. Derudover kan de ovenstående endpoints bruges til hhv. at se den generelle status for servicen (isAlive) samt at overvåge om export af ændringer foreløber fejlfrit.
...