Overblik

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

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

skr-service: Selve Stamkortregister-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 skr-service.

Ændringslog

Version	Dato	Ændring	Ansvarlig
	2018-08-31	Initialt dokument	Trifork
1.0.11	2019-08-02	Ændret WSDL-stier	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>/skr-service/isAlive	Status-side for servicen. Viser om servicen fungerer korrekt, se afsnittet Overvågning.
<server>/skr-service/skr	Webservice-endpoint
<server>/skr-service/dksconfig	DCC auto-konfigurations API. Anvendes til konfiguration af NSP'ens DCC.
<server>/skr-service/wsdl	HTML-side med links til download af WSDL-filer i hhv. DGWS- og IDWS-udgave.
<server>/skr-service/wsdl/dgws20190801	DGWS WSDL
<server>/skr-service/wsdl/idws20190801	IDWS WSDL

Kald via proxy-komponenten

URL	Funktionalitet
<server>/skr/proxy/isalive	Status-side for proxy-komponenten. Viser om komponenten fungerer korrekt, se afsnittet Overvågning.
<server>/skr/proxy/version	Viser version for proxy-komponenten.
<server>/skr/skr	Samme som ovenfor, blot går kaldet igennem proxy-komponenten.
<server>/skr/isAlive	Samme som ovenfor, blot går kaldet igennem proxy-komponenten.
<server>/skr/dksconfig	Samme som ovenfor, blot går kaldet igennem proxy-komponenten.
<server>/skr/wsdl	Samme som ovenfor, blot går kaldet gennem proxy-komponenten.
<server>/skr/wsdl/dgws20190801	Samme som ovenfor, blot går kaldet gennem proxy-komponenten.
<server>/skr/wsdl/idws20190801	Samme som ovenfor, blot går kaldet gennem proxy-komponenten.

Daglig drift

Servicen kræver ingen daglig vedligeholdelse udover sædvanlig systemovervågning.

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: skr-service
Deployed: 2018-08-10T10:55:17.777Z
Build-Date: 2018-08-10T10:52:22Z
Build-Version: 1.0.0-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
skr_service.log	Applikationslog for servicen, som indeholder de vigtigste systemhændelser. Root: WARN org.springframework.boot: INFO org.springframework.core: INFO dk.sundhedsdatastyrelsen.stamkortregister: INFO
nsputil-sla-skr.log	SLA-log. Indeholder SLA-logninger for alle kald på servicen. Indeholder desuden SLA-logninger for servicens kald til MinLog.
skr_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.
skr_proxy.log	Applikationslog for DGWS/IDWS proxyen (wsproxy komponenten). Denne logfil indeholder detaljer omkring hvilke kald, der delegeres videre til servicen af proxyen.

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.