Indhold

Introduktion

Formål

Denne guide har som formål at give et overblik over drift af LAR servicen.

Læsevejledning

Dette dokument er henvendt til driftspersonale på NSP'en. 

Læseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til WildFly applikation server, MariaDB og java.

Dokument historik

1.4. Definitioner og referencer

Funktionalitet

LAR servicen udstiller SOAP snitflader til at registrere og læse CAVE oplysninger.

Daglig drift

Servicen kræver ingen særlig daglig vedligehold. 

Opdatering af whitelist database

Servicen den indeholder en whitelist database over CVR numre der har adgang til servicen. 

Indsæt i whitelist databasen

insert into whitelist_config (service_key, service_type, cvr) values ('dk.nsi.larservice', '', 'CVR_NUMMER_DER_SKAL_INDSÆTTES');

Slet i whitelist databasen

delete from whitelist_config where service_key = 'dk.nsi.larservice' and cvr = 'CVR_NUMMER_DER_SKAL_SLETTES';

Overvågning

Servicen udstiller en status side. På denne side fremgår servicens versionsnummer samt status for adgang til databasen. Status siden kan tilgås via http://CAVE/larservice/health

Eksempel på svar på fra status-sidem. 

HTTP/1.1 200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Content-Type: application/json
Content-Length: 102
Date: Mon, 04 Oct 2021 11:31:27 GMT   

{ "version": "1.0.9-SNAPSHOT", "TreatmentRelationClient" : "OK", "ConsentClient" : "OK", "CaveClient" : "OK"}

HTTP statuskode

Status-siden returnerer altid følgende status kode retur uafhængigt at af de services der integreres med. 

200: Applikationen er sund

Fejlfinding

Såfremt der er problemer med adgang til servicens database, vises nedenstående fejl. Bemærk at man i body kan se, at det er cave servicen der ikke er OK.

HTTP/1.1 200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Content-Type: application/json
Content-Length: 103
Date: Mon, 04 Oct 2021 11:31:27 GMT   


{ "version": "1.0.9-SNAPSHOT", "TreatmentRelationClient" : "OK", "ConsentClient" : "OK", "CaveClient" : "FAILED"}

Følgende årsager kan resultere i en FAILED status 

• Hvis servicen, der integreres med ikke er tilgængelig
• Andre ukende årsager

Hvis status-siden returnerer en FAILED status, bør man tjekke applikationsloggen, da fejl logges her til. 

Servicen kan genstartes ved at genstarte den docker container, som servicen den kører i. 

Logfiler og fortolkning af disse

Alle logfiler findes i standard logfolderen på NSP platformen. Det vil sige at de findes i folderen /pack/wildfly8/standalone/log. 

Nedenstående er de relevante logfiler. 

Krav til backup m.m.

Der bør foretages backup af data på en forsvarlig måde, i tilfælde af behov for en genetablering af data. Disse skal opbevares på en forsvarlig måde, jfr. regler om personfølsomme data.

Initiel indlæsning af data

Det er muligt at indlæse data fra en CSV-fil direkte ind i LAR.

Inputfilens format

CVS-filen forventes at have følgende format:

1) første linje indeholder navnene på alle felterne (adskilt af semikolon ";". Felterne er beskrevet i afsnit 4.1.1 i denne guide.

Rækkefølgen af felterne skal være den samme som i tabellen.

2) I de efterfølgende rækker kommer data. De skal også være adskilt med semikolon og komme i samme rækkefølge som i tabellen i afsnit 4.1.1

Felter der er markeret med "Ja" i tabellen er krævede.

Afvikling af indlæsningsprogram

Indlæsningsprogrammet afvikles i en docker container og det skal ske i følgende steps (alle stier er relative i forhold til lar/trunk):

1) Inputfilen kopieres ind i det directory der er volume mountes ind i containeren: i compose/dataimporter/input/

2) I application.properties angives input filen i denne property: larservice.dataimport.inputfile

3) Her efter kan indlæsningen afvikles:

compose/dataimporter/docker-compose up

Resultatet af indlæsningen udskrives i loggen.

Properties

Der findes følgende properties, men det bør ikke være nødvendigt at ændre dem fra kørsel til kørsel (bortset fra larservice.dataimport.inputfile):