Overblik

Driftsvejledningen indeholder information der er relevant for driften af Behandlingstestamenteregister-servicen (BTR), herunder oplysninger om standard placering af log- og konfigurationsfiler, eksterne afhængigheder og fejlfinding.

I produktion består Behandlingstestamenteregister-servicen af 2 komponenter (war-arkiver) der er deployet på en Wildfly applikationsserver:

ltr-btr-service-wildfly: Selve Behandlingstestamenteregister-servicen. Denne afhænger af adgang til 2 MariaDB datasources. Desuden afhænger den af at kunne kalde (skrive til) MinLog-servicen.
wsproxy: DGWS/IDWS proxy der håndterer requests og responses og internt viderestiller til ltr-btr-service-wildfly.

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
1.0.14	2019-25-09	Ajourført	Trifork
1.1.0	2020-03-24	TreatmentWillV2 med noLifeProlongingIfDying uden angivelse af yderligere accept	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.

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
<server>/btr-service/wsdl/btrV2/dgws	Behandlingstestamenteregistret version 2: DGWS WSDL
<server>/btr-service/wsdl/btrV2/idws	Behandlingstestamenteregistret version 2: 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.
<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.

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.

Eksempel på et response fra status-siden:

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:

Hvis mindst én databaserne ikke er tilgængelige. Der overvåges databaseadgang ved et simpelt "SELECT 1" statement. Denne query køres på alle datasources.
Andre ukendte årsager.

Hvis status-siden giver HTTP 500 bør man checke den servicens log, som burde indeholde en detaljeret fejlmeddelelse med stacktrace.

Logning

Følgende beskrivelse af logning i servicen tager udgangspunkt i standard-opsætningen. Logning konfigureres vha. konfigurationsfilerne beskrevet i installationsvejledningen.

Alle logfiler placeres i standalone/log i Wildfly.

Alle logninger er konfigureret med en rolling file appender, der indsætter et postfix i filnavnet på historiske logfiler ud fra følgende pattern:

-%d{MM-dd-yyyy}-%i

Der oprettes således en logfil pr. dag, og desuden oprettes endnu en logfil, når en logfil er blevet 10 MB stor.

Følgende tabel over logfiler beskriver, hvilke komponenter der skriver til dem:

Logfilnavn	Indhold
btr_service.log	Applikationslog for servicen, som indeholder de vigtigste systemhændelser. Root: WARN org.springframework.boot: INFO org.springframework.core: INFO dk.sundhedsdatastyrelsen.livstestamente: INFO
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.