Driftsvejledningen indeholder information der er relevant for driften af Organdonorregister-servicen (ODR), herunder oplysninger om standard placering af log- og konfigurationsfiler, eksterne afhængigheder og fejlfinding.
I produktion består Organdonorregister-servicen af 2 komponenter (war-arkiver) der er deployet på en Wildfly applikationsserver:
Desuden findes også en migreringskomponent, odr-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-11-23 | Tilføjet admin endpoints | Trifork |
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>/odr-service/isAlive | Status-side for servicen. Viser om servicen fungerer korrekt, se afsnittet Overvågning. |
<server>/odr-service/odr | Webservice-endpoint |
<server>/odr-service/odrAdmin | Webservice admin-endpoint (til brug for brugerflade) |
<server>/odr-service/dksconfig | DCC auto-konfigurations API. Anvendes til konfiguration af NSP'ens DCC. |
<server>/odr-service/wsdl | HTML-side med links til download af WSDL-filer i hhv. DGWS- og IDWS-udgave. |
<server>/odr-service/wsdl/dgws | DGWS WSDL |
<server>/odr-service/wsdl/idws | IDWS WSDL |
URL | Funktionalitet |
---|---|
<server>/odr/proxy/isalive | Status-side for proxy-komponenten. Viser om komponenten fungerer korrekt, se afsnittet Overvågning. |
<server>/odr/proxy/version | Viser version for proxy-komponenten. |
<server>/odr/odr | Samme som ovenfor, blot går kaldet igennem proxy-komponenten. |
<server>/odr/odrAdmin | Samme som ovenfor, blot går kaldet igennem proxy-komponenten. |
<server>/odr/isAlive | Samme som ovenfor, blot går kaldet igennem proxy-komponenten. |
<server>/odr/dksconfig | Samme som ovenfor, blot går kaldet igennem proxy-komponenten. |
<server>/odr/wsdl | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
<server>/odr/wsdl/dgws | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
<server>/odr/wsdl/idws | Samme som ovenfor, blot går kaldet gennem proxy-komponenten. |
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.
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: odr-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 |
Status-siden returnerer følgende HTTP statuskoder afhængig af servicens status:
Følgende årsager kan resultere i en statuskode 500:
Hvis status-siden giver HTTP 500 bør man checke den servicens log, som burde indeholde en detaljeret fejlmeddelelse med stacktrace.
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 |
---|---|
odr_service.log | Applikationslog for servicen, som indeholder de vigtigste systemhændelser. Root: WARN |
nsputil-sla-odr.log | SLA-log. Indeholder SLA-logninger for alle kald på servicen. Indeholder desuden SLA-logninger for servicens kald til MinLog. |
odr_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. |
odr_proxy.log | Applikationslog for DGWS/IDWS proxyen (wsproxy komponenten). Denne logfil indeholder detaljer omkring hvilke kald, der delegeres videre til servicen af proxyen. |
Servicens slettejob kører automatisk efter det konfigurede scheduling-pattern. Størrelsen af batches kan konfigureres som beskrevet i installationsvejledningen.
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.