Page History
Navitabs | ||
---|---|---|
| ||
Overblik
Driftsvejledningen indeholder information der er relevant for driften af Livs- og behandlingstestamenteregister-servicen (LTR-BTR), herunder oplysninger om standard placering af log- og konfigurationsfiler, eksterne afhængigheder, start/stop/genstart og fejlfinding.
...
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.
Ændringslog
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 |
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.
Direkte kald på service-komponenten
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 |
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. |
<server>/btr/dksconfig | 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. |
Daglig drift
Servicen kræver ingen daglig vedligeholdelse udover sædvanlig systemovervågning.
Alt data (inkl. historiske data) for en borger fjernes 1 år efter borgerens død ved hjælp af et integreret slettejob.
Overvågning
Servicen udstiller en status-side (isAlive). På denne side fremgår servicens version, opstartstidspunkt mm. samt status for slettejob.
...
Code Block |
---|
200 OK Title: ltr-btr-service-wildfly Deployed: 2018-08-10T10:55:17.777Z Build-Date: 2018-08-10T10:52:22Z Build-Version: 1.0.1-SNAPSHOT Builder: A robot Display time: 2018-08-10T12:57:43.577Z Delete job: Enabled, Last successful deletion: 1900-01-01T00:00:00Z, Error count: 0 |
HTTP statuskode
Status-siden returnerer følgende HTTP statuskoder afhængig af servicens status:
- 200: Applikationen kører i øjeblikket fint.
- 500: Der er opstået en fejl, der kræver indgriben.
Fejlfinding
Følgende årsager kan resultere i en statuskode 500:
...
Alle komponenter kan genstartes ved at opdatere war-filens last access time med Unix-kommandoen touch, hvilket automatisk detekteres af Wildfly's deploynent scanner. Alternativt kan Wildfly genstartes.
Logning
Følgende beskrivelse af logning i servicen tager udgangspunkt i standard-opsætningen. Logning konfigureres vha. konfigurationsfilerne beskrevet i installationsvejledningen.
...
Logfilnavn | Indhold |
---|---|
btr_service.log | Applikationslog for servicen, som indeholder de vigtigste systemhændelser. Root: WARN |
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.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 proxyen. |
Slettejob
Servicens slettejob kører automatisk efter det konfigurede scheduling-pattern. Størrelsen af batches kan konfigureres som beskrevet i installationsvejledningen.
Backup
Servicen indeholder ikke nogen backup-mekanismer, og dette skal derfor konfigureres på database-niveau. Der bør foretages backup af data på en forsvarlig måde, i tilfælde af behov for en genetablering af data. Disse data skal opbevares på en forsvarlig måde, jfr. regler om personhenførbare data.