Introduktion

Formål

Vejledning til installation og konfiguration af CAVE. 

Vejledningen indeholder servicekrav til det omliggende miljø, herunder krav til operativsystem. 

Vejledningen beskriver hvorledes servicen deployeres, herunder om der er krav om evt. genstart af server eller andre applikationer.

Ved opgradering af komponenten beskrives desuden tilstanden, systemet skal være i for at opgraderingen kan finde sted.

Læsevejledning

Læseren forventes at have kendskab til National Sundheds-IT’s platform NSP, samt generelt kendskab til WildFly applikation server, docker og Ubuntu Linux operativ system.

Definitioner og referencer

Docker image

CAVE leveres som et docker image og kan hentes fra registry.nspop.dk/playground/cave:snapshot. Der leveres eksempel på docker-compose.yml fil sammen med kildekoden. Compose filen kan findes i folderen compose/release i roden af kildekoden. I compose filen er der også refrence til eksempler på konfigurationsfiler. 

...

Servicen er testet mod MariaDB version 10.1.37, som bliver brugt på NSP platformen.

Krav til datahåndtering

CAVE servicen behandler og gemmer personfølsomme informationer.

Krav til hardware

LAR servicens ressourceforbrug vil afhænge af følgende:

• Antallet og størrelsen af samtidige læsninger af lægemiddelallergier.

• Antallet af samtidige lægemiddelallergiregistreringer (skrivninger).

Konfiguration

Filnavne og stier til disse tager udgangspunkt i hvor de er mounted i docker countaineren. 

Servicekonfiguration

Grundlæggende konfiguration foregår ved redigering af filen /pack/wildfly8/modules/sds/cave/configuration/main/cave.properties

...

CAVE service er ikke en SOAP WebService og har ikke DGWS som sikkerhedsmodel. Derfor skal den ikke anvende NSP access handler. Derfor er access handleren slået fra i det leverede docker image. Det sker ved at overskrive filen /pack/wildfly8/modules/system/layers/base/dk/sds/nsp/accesshandler/main/handler.skip.

Opgradering af CAVE

Når der kommer opgraderinger til en komponent, vil der medfølge en release-note, der beskriver hvad opgraderingen består af, samt hvilke handlinger der er nødvendige for at opgradere den deployerede komponent.

Database

Servicen kræver en tom database inden den startes første gang. Navn på databasen er konfigurerbart i datasource filen. Servicen sørger selv for at oprette tabeller, indexer osv. første gang den startes op.  Se compose/database for eksempel på script til at oprette database.