Page History
...
I produktion består Behandlingstestamenteregister-servicen af 2 komponenter en komponente (war-arkiverarkiv), der er deployet på en Wildfly applikationsserver: ltr-btr-service-wildfly:
...
Denne afhænger af adgang til 2 MariaDB datasources. Desuden afhænger den af at kunne kalde (skrive til) MinLog-servicen
...
.
Desuden findes også en migreringskomponent, ltr-migration, som kun anvendes ved migreringen af data fra det gamle register, og derfor skal denne ikke være deployet i normal produktion.
...
Version | Dato | Ændring | Ansvarlig |
|---|---|---|---|
1.0.1 | 2018-08-17 | Initialt dokument | Trifork |
| 1.0.2 | 2018-08-31 | Ny release | Trifork |
| 1.0.3 | 2018-09-06 | Endpoints ændret fra /ltr-btr til /btr | Trifork |
| 1.0.4 | 2018-11-23 | Tilføjet admin endpoints | Trifork |
| 1.0.14 | 2019-25-09 | Ajourført | Trifork |
| 1.1.0 | 2020-03-24 | TreatmentWillV2 med noLifeProlongingIfDying uden angivelse af yderligere accept | KvalitetsIT |
| 1.1.1 | 2020-03-30 | Afvisning af yderligere accept for uafvendeligt døende på TreatmentWill-snitflade | KvalitetsIT |
| 1.1.3 | 2020-05-26 | Opdateret slettejob | KvalitetsIT |
| 1.1.7 | 2021-09-06 | Opdateret ifm. udfasning af dgws/idws-proxy. | KvalitetsIT |
Funktionalitet
Servicen udstiller en række data som beskrevet i anvenderguiden. Komponenten kaldes af anvendere gennem NSP'ens DCC (afkoblingskomponenten), som viderestiller kaldet til servicens webservice-endpoint. Servicen udstiller derudover en række administrative og konfigurationsrelaterede funktionaliter.
...
URL | Funktionalitet |
|---|---|
<server>/btr-service/isAlive | Status-side for servicen. Viser om servicen fungerer korrekt, se afsnittet Overvågning. |
<server>/btr-service/dksconfig/ltr | Livstestamenteregistret: DCC auto-konfigurations API. Anvendes til konfiguration af NSP'ens DCC. |
<server>/btr-service/ltr | Livstestamenteregistret: Webservice-endpoint |
<server>/btr-service/btr | Behandlingstestamenteregistret: Webservice-endpoint |
<server>/btr-service/ltrAdmin | Livstestamenteregistret: Webservice admin-endpoint (til brug for brugerflade) |
<server>/btr-service/btrAdmin | Behandlingstestamenteregistret: Webservice admin-endpoint (til brug for brugerflade) |
<server>/btr-service/dksconfig/btr | Behandlingstestamenteregistret: DCC auto-konfigurations API. Anvendes til konfiguration af NSP'ens DCC. |
<server>/btr-service/wsdl | HTML-side med links til download af WSDL-filer i hhv. DGWS- og IDWS-udgave. |
<server>/btr-service/wsdl/ltr/dgws | Livstestamenteregistret: DGWS WSDL |
<server>/btr-service/wsdl/ltr/idws | Livstestamenteregistret: IDWS WSDL |
<server>/btr-service/wsdl/btr/dgws | Behandlingstestamenteregistret: DGWS WSDL |
<server>/btr-service/wsdl/btr/idws | Behandlingstestamenteregistret: IDWS WSDL |
<server>/btr-service/wsdl/btrV2/dgws | Behandlingstestamenteregistret version 2: DGWS WSDL |
<server>/btr-service/wsdl/btrV2/idws | Behandlingstestamenteregistret version 2: IDWS WSDL |
<server>/btr-service/syncjob/ltr/start | Slettejob for LTR startes ved kald af denne url, og personer, som har været døde i et år eller mere, slettes fra LivingWill tabellen. Returnerer tidspunkt for modtaget request og http status kode 200 |
<server>/btr-service/syncjob/ltr/status | Oplysninger om slettejob for LTR på den pågældende server. Oplysningerne gemmes i hukommelsen på serveren og fosvinder ved genstart. Der returneres http status kode 200 og følgende data: tidspunkt for sidste afvikling af slettejob på serveren (hvis værdien findes ellers tom værdi), status for sidste afvikling på serveren (true=ingen fejl, false=fejl, tom tekst=ikke afviklet) og fejlbesked ved sidste afvikling (hvis findes ellers er værdien udeladt) |
<server>/btr-service/syncjob/btr/start | Slettejob for BTR startes ved kald af denne url, og personer, som har været døde i et år eller mere, slettes fra TreatmentWill tabellen. Returnerer tidspunkt for modtaget request og http status kode 200 |
<server>/btr-service/syncjob/btr/status | Oplysninger om slettejob for BTR på den pågældende server. Oplysningerne gemmes i hukommelsen på serveren og fosvinder ved genstart. Der returneres http status kode 200 og følgende data: tidspunkt for sidste afvikling af slettejob på serveren (hvis værdien findes ellers tom værdi), status for sidste afvikling på serveren (true=ingen fejl, false=fejl, tom tekst=ikke afviklet) og fejlbesked ved sidste afvikling (hvis findes ellers er værdien udeladt) |
Kald via proxy-komponenten
URL | Funktionalitet |
|---|---|
<server>/btr/proxy/isalive | Status-side for proxy-komponenten. Viser om komponenten fungerer korrekt, se afsnittet Overvågning. |
<server>/btr/proxy/version | Viser version for proxy-komponenten. |
<server>/btr/ltr | Samme som ovenfor, blot går kaldet igennem proxy-komponenten. |
<server>/btr/btr | Samme som ovenfor, blot går kaldet igennem proxy-komponenten. |
<server>/btr/ltrAdmin | Samme som ovenfor, blot går kaldet igennem proxy-komponenten. |
<server>/btr/btrAdmin | Samme som ovenfor, blot går kaldet igennem proxy-komponenten. |
<server>/btr/isAlive | Samme som ovenfor, blot går kaldet igennem proxy-komponenten. |
| Samme som ovenfor, blot går kaldet igennem proxy-komponenten. | |
<server>/btr/wsdl | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
<server>/btr/wsdl/ltr/dgws | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
<server>/btr/wsdl/ltr/idws | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
<server>/btr/wsdl/btr/dgws | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
<server>/btr/wsdl/btr/idws | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
<server>/btr/wsdl/btrV2/dgws | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
<server>/btr/wsdl/btrV2/idws | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
Daglig drift
Servicen kræver ingen daglig vedligeholdelse udover sædvanlig systemovervågning.
...
Følgende tabel over logfiler beskriver, hvilke komponenter der skriver til dem:
Logfilnavn | Indhold | ||
|---|---|---|---|
| accesshandler.log | Log for accesshandler-biblioteket. | ||
| access.log | Access-log. | ||
btr_audit.log | Auditlog. Indeholder logning af, hvem der har kaldt, hvilken SOAP-action der blev kaldt, hvilken person der blev kaldt for, hvordan der blev kaldt (DGWS/IDWS), hvornår der blev kaldt samt kaldets varighed. | ||
btr_service.log | Applikationslog for servicen, som indeholder de vigtigste systemhændelser. Root: WARN | ||
| nsp-kafka.log | Log for kafka-produceren, som står for skrivning til MinLog. | ||
| nsputil-sla-btr.log | SLA-log. Indeholder SLA-logninger for alle kald på servicen. Indeholder desuden SLA-logninger for servicens kald til MinLog. | btr_audit||
| server.log | Auditlog. Indeholder logning af, hvem der har kaldt, hvilken SOAP-action der blev kaldt, hvilken person der blev kaldt for, hvordan der blev kaldt (DGWS/IDWS), hvornår der blev kaldt samt kaldets varighed. | btr_proxy.log | Applikationslog for DGWS/IDWS proxyen (wsproxy komponenten). Denne logfil indeholder detaljer omkring hvilke kald, der delegeres videre til servicen af proxyenLog for Wildfly-serveren. |
Slettejob
Slettejob for hver service bliver afviklet vha. en udstillet RestController, som kaldes vha. simpelt HTTP GET kald.
Dette gøres for at sikre afviklingen af slettejob i flere-node drift, hvor en loadbalancer sørger for fordeling af kald til bagvedliggende servere.
Driften vedligeholder en cron, som kalder slettejobbets url i et fast mønster vha. curl.
Følgende parametre til styring af slettejobbet kan ændres i application.properties for LTR:
jobs.delete.cpr-max-results.ltr=25
jobs.delete.cpr-max-loops.ltr=2
og BTR:
...
Hvor jobs.delete.cpr-max-results.xxx bestemmer antal af cpr numre, der skal udtrækkes til sletning. Og jobs.delete.cpr-max-loops.xxx bestemmer antal gange udtræk af cpr numre skal gennemføres.
Hvis tiden til afvikling af slettejob overskrider 20-25 sekunder, så bør ovenstående parametre gøres mindre.
Kommando til kald af slettejob for LTR:
curl <server>/btr-service/syncjob/ltr/start
og BTR:
curl <server>/btr-service/syncjob/btr/start
Slettejobbet skal for LTR aktiveres hver dag, hvert 15. minut mellem 8.05-16.05 - startende kl. 8.05
Slettejobbet skal for BTR aktiveres hver dag, hvert 15. minut mellem 8.10-16.10 - startende kl. 8.10
Med mindre ovenstående parametre ændres, så vil slettejobbet behandle op til 1550 sletninger om dagen. (I gennemsnit er der 150 døde pr. døgn)
...