1. Indhold

2. Introduktion

2.1. Formål

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

2.2. 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.

2.3. Dokument historik

2.4. 1.4. Definitioner og referencer

3. Funktionalitet

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

4. Daglig drift

Servicen kræver ingen særlig daglig vedligehold. 

5. 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';

6. 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: Wed, 20 Feb 2019 13:23:54 GMT


{"minLogOk":true,"consentOk":true,"treatmentRelationOk":true,"caveOk":true,"version":"1.0.0-SNAPSHOT"}

6.1. HTTP statuskode

Status-siden returnerer følgende status koder afhængig af servicens status. 

200: Applikationen er sund

500: Der er opstået en fejl i applikationen eller en af de services der integreres med.

6.2. Fejlfinding

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

HTTP/1.1 500 Internal Server Error
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Content-Type: application/json
Content-Length: 103
Date: Wed, 20 Feb 2019 13:30:11 GMT


{"minLogOk":true,"consentOk":true,"treatmentRelationOk":true,"caveOk":false,"version":"1.0.0-SNAPSHOT"}

Følgende årsager kan resultere i en statuskode 500. 

• Hvis en af de 4 services, der integreres med ikke er tilgængelige. 
• Andre ukende årsager

Hvis status-siden returnerer HTTP status 500 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. 

7. 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. 

8. 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.