1. Indhold
2. Introduktion
2.1. 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.
2.2. 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.
2.3. Dokument historik
Dato | Ansvarlig | Beskrivelse |
|---|---|---|
| 5/2-2018 | KvalitetsIT | Initiel version |
2.4. Definitioner og referencer
Reference | Beskrivelse |
|---|---|
| LAR | Lægemiddelallergiregisrering |
| SDS | Sundhedsdatastyrelsen |
| NSP | Den nationale service platform (inden for sundheds-IT) |
| Driftsvejledning | CAVE - Driftsvejledning |
3. 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.
4. Krav til miljø
Kravene er baseret på det driftsmiljø, der aktuelt er gældende på den Nationale Service Platform (NSP).
4.1. Krav til operativsystem
Der stilles ingen krav til operativsystemet udover, at Linux og docker skal være installeret.
4.2. Krav til database
Servicen er testet mod MariaDB version 10.1.37, som bliver brugt på NSP platformen.
4.3. Krav til datahåndtering
CAVE servicen behandler og gemmer personfølsomme informationer.
4.4. 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).
5. Konfiguration
Filnavne og stier til disse tager udgangspunkt i, hvor de er mounted i docker countaineren.
5.1. Servicekonfiguration
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 |
| drugId.oid | Kode system for identifikation af drug id. Sættes til urn:oid:1.2.208.176.1.2 |
| 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. |
5.2. SLA-log konfiguration
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.
5.3. Log4j konfiguration
Log4j konfiguration findes i /pack/wildfly8/modules/sds/cave/configuration/main/log4j.xml.
5.4. Logback konfiguration
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.
5.5. Datasource konfiguration
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.
5.6. Accesshandler
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.
6. 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.
7. 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.