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.
Kravene er baseret på det driftsmiljø, der aktuelt er gældende på den Nationale Service Platform (NSP).
Der stilles ingen krav til operativsystemet udover at det skal være Linux og docker skal være installeret.
Servicen er testet mod MariaDB version 10.1.37, som bliver brugt på NSP platformen.
Grundlæggende konfiguration foregår ved redigering af filen /pack/wildfly8/modules/sds/cave/configuration/main/cave.properties
Property | Beskrivelse |
|---|---|
cpr.oid | Kode system for identifikation af patienten. Sættes til urn:oid:1.2.208.176.1.2 |
| atc.oid | Kommasepareret liste af valide kode systemer for identifikation af medikament. Sættes til urn:oid:2.16.840.1.113883.6.73 |
| sks.oid | Kommasepareret liste af valide kode systemer for identifikation af reaktion. Sættes til urn:oid:1.2.208.176.2.4.12 |
| autorisation.oid | Kommasepareret liste af valide kode systemer for identifikation af indberetter. Sættes til urn:oid:1.2.208.176.1.3 |
| sor.oid | Kommasepareret liste af valide kode systemer for identifikation af indberetter organisation. Sættes til urn:oid:1.2.208.176.1.1 |
| sla.log.short.app.name | Kort applikationsnavn til brug i forbindelse med SLA log. Sættes til CAVE. |
| sla.log.app.name | Applikationsnavn til brug i forbindelse med SLA log. Sættes til "CAVE service". |
| base.url | Angiver base url for det endpoint LAR servicen kender. |
SLA-logning på CAVE Service udføres ved hjælp af SLALogItem fra nsp-util pakken.
Konfiguration af SLA-log findes i filen nspslalog-cave.properties samt den Log4j fil der står i nspslalog-cave.properties.
Log4j konfiguration findes i /pack/wildfly8/modules/sds/cave/configuration/main/log4j.xml.
Logback konfiguration findes i /pack/wildfly8/modules/sds/cave/configuration/main/logback.xml. Logback anvendes som logging framework i HAPI FHIR frameworket der anvendes i CAVE servicen.
CAVE servicen kræver en datasource med JNDI navn java:jboss/datasources/cave. Se i øvrigt eksempel på datasource fil i den fil der er leveret sammen med docker-compose.yml eksempel. Filen hedder /pack/wildfly8/standalone/deployments/cave-ds.xml.
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.
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.