Page History
Table of Contents |
---|
Introduktion
Formål
Denne guide har som formål at give et overblik over, hvordan CAVE servicen kaldes.
Læsevejledning
Dette dokument er henvendt til driftspersonale på NSP'en.
æseren forventes at have kendskab til National Sundheds-IT's platform NSP, samt generelt kendskab til WildFly applikation server, MariaDB og java.
Dokument historik
Dato | Ansvarlig | Beskrivelse |
---|---|---|
5/2-2018 | KvalitetsIT | Initiel version |
Definitioner og referencer
Rerence | Beskrivelse |
---|---|
REST | Representational State Transfer |
FHIR | Fast Health Interoperability Resources |
HAPI | HAPI-FHIR - Open Source FHIR implementation in Java |
Funktionalitet
CAVE servicen udstiller REST snitflader til at registrere og læse CAVE oplysninger.
Daglig drift
Servicen kræver ingen særlig daglig vedligehold.
...
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/cave/health
Eksempel på svar på s
HTTP statuskode
Fejlfinding
Logfiler og fortolkning af disse
fra status-sidem.
Code Block |
---|
HTTP/1.1 200 OK
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Transfer-Encoding: chunked
Content-Type: application/json
Date: Mon, 18 Feb 2019 08:01:04 GMT
{ "version": "0.0.1-SNAPSHOT", "database": "true"} |
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. Det kan f.eks. være den ikke kan få adgang til databasen.
Fejlfinding
Såfremt der er problemer med adgang til servicens database, vises nedenstående fejl. Bemærk at den giver en HTTP statuskode 500.
Code Block |
---|
HTTP/1.1 500 Internal Server Error
Connection: keep-alive
X-Powered-By: Undertow/1
Server: WildFly/8
Transfer-Encoding: chunked
Content-Type: application/json
Date: Mon, 18 Feb 2019 08:50:53 GMT
{ "version": "0.0.1-SNAPSHOT", "database": "false"} |
Følgende årsager kan resultere i en statuskode 500.
- Hvis databasen ikke er tilgængelig. Dtabasen overvåges med en en simpel "select 1" forespørgsel.
- 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.
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.
Filnavn | Indhold |
---|---|
cave.log | Applikationslog fra CAVE servicen. |
hapi.log | Log fra HAPI FHIR framework. |
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 personhenførbare >>> personhenførbare eller personfølsomme? <<< data
...
.