Vejledning til installation og konfiguration af LAR.
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æ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.
Dato | Ansvarlig | Beskrivelse |
|---|---|---|
| 26/2-2018 | KvalitetsIT | Initiel version |
Reference | Beskrivelse |
|---|---|
| LAR | Lægemiddelallergiregisrering |
| SDS | Sundhedsdatastyrelsen |
| NSP | Den nationale service platform (inden for sundheds-IT) |
| Driftsvejledning | LAR - Driftsvejledning |
LAR leveres som et docker image og kan hentes fra registry.nspop.dk/playground/larservice: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.
Komponenterne er udviklet og testet i Docker ved anvendelse af imaget registry.nspop.dk/playground/nspbase:0.1.
Komponenternes konfiguration er således tilpasset deployering på WildFly 8.2 applikationsservere (krav til Java 8).
Der stilles ingen krav til operativsystemet udover, at det skal være Linux, og docker skal være installeret.
LAR servicen er afhægning af den bagvedliggende FHIR-baserede CAVE service. CAVE servicen er dokumenteret særskilt her: CAVE service.
LAR servicen behandler (videresender) personfølsomme informationer.
LAR service gemmer ikke selv disse data, da dette håndteres i den bagvedliggende CAVE service.
LAR servicens ressourceforbrug vil afhænge af følgende:
Antallet og størrelsen af samtidige læsninger af lægemiddelallergier.
Filnavne og stier til disse tager udgangspunkt i, hvor de er mounted i docker countaineren.
Grundlæggende konfiguration foregår ved redigering af filen /pack/wildfly8/modules/sds/larservice/configuration/main/application.properties
Property | Beskrivelse |
|---|---|
cave.base.get | Endpoint for get operationer mod CAVE servicen. F.eks. http://cave.sdsd.dk/cave/fhir/ |
| cave.base.post | Endpoint for post operationer mod CAVE servicen. F.eks. http://cave.sdsd.dk/cave/fhir/ |
| cave.base.put | Endpoint for put operationer mod CAVE servicen. F.eks. http://cave.sdsd.dk/cave/fhir/ |
| treatmentRelation.enabled | Angiver om integration med behandler relation er er slået til. Skal altid være true i produktion. |
| treatmentRelation.endpoint | Endpoint til behandler relation wsdl. |
| samtykke.enabled | Angiver om integration med MinSpærring er slået til. Skal altid være true i produktion. |
| samtykke.endpoint | Endpoint til MinSpærring. |
| minLog.enabled | Angiver om integration til MinLog er slået til. Skal være true i produktion. |
| minLog.endpoint | Endpoint til MinLog. |
| minLog.read.text | Angiver den tekst der skal skrives i min log ved læsning af oplysninger. |
| executor.maxThreadCount | Maksimalt antal parrallele tråde der anvendes når MingLog MinSpærring og behandlerrelation kaldes. |
| dgws.validation.disabled | Angiver om DGWS validering skal slås fra. Skal altid være false i produktion. |
| idcard.version | Angiver krævede version af id kort. F.eks. 1.0.1. |
| sts.test.mode | Angiver om det er test STS'en der skal anvendes. Skal altid være false i produktion. |
| idcard.max.age.hours | Id kort maksimal alder. F.eks. 24 |
| whitelist.id | ID navn til brug i whitelist database. |
registerPatientAllergy.min.sec.level | Minimum security level på id kort til soap operationen RegisterPatientAllergy. Skal være 3 i produktion. NO_AUTHENTICATION = 1 |
getPatientAllergyList.min.sec.level | Minimum security level på id kort til soap operationen GetPatientAllergyList. Skal være 4 i produktion. NO_AUTHENTICATION = 1 |
| updatePatientAllergyList.min.sec.level | Minimum security level på id kort til soap operationen updatePatientAllergy. Skal være 3 i produktion. NO_AUTHENTICATION = 1 |
| log.config.file | Log4j kongigurationsfil. |
| treatment.relation.serviceprovider.name | Indsættes som ’Serviceprovider/Name’ i behandlingsrelationsservicens treatmentRelationRequestBody |
| treatment.relation.serviceprovider.vendor | Indsættes som ’ServiceProvider/Vendor’ i behandlingsrelationsservicens treatmentRelationRequestBody |
| treatment.relation.serviceprovider.version | Indsættes som ’ServiceProvider/Version’ i behandlingsrelationsservicens treatmentRelationRequestBody |
| treatment.relation.lookup.timeinterval.start.offset | Angiver antallet af dage fra LAR-kaldtidspunktet, der skal indsættes som tidsstemplet ’RelationLookupTimeInterval/start’ i behandlingsrelationsservicens treatmentRelationRequestBody. Negativt fortegn angiver antal dage før LAR-kaldtidspunktet. |
| treatment.relation.lookup.timeinterval.end.offset | Angiver antallet af dage fra LAR-kaldtidspunktet, der skal indsættes som tidsstemplet ’RelationLookupTimeInterval/end’ i behandlingsrelationsservicens treatmentRelationRequestBody. Negativt fortegn angiver antal dage før LAR-kaldtidspunktet. |
| treatment.relation.timelimit.offset | Angiver antallet af dage fra LAR-kaldtidspunktet, der skal indsættes som tidsstemplet ’TimeLimit’ i behandlingsrelationsservicens treatmentRelationRequestBody. |
| treatment.relation.queryable.cvr | Indsættes som ’QueryableCvr’ i behandlingsrelationsservicens treatmentRelationRequestBody |
| treatment.relation.external.reference.id | Indsættes som ’ExternalReferenceId’ i behandlingsrelationsservicens treatmentRelationRequestBody |
| treatment.relation.acceptable.relations | Kommasepareret liste af kategorier, der indsættes som ’AcceptableRelations/Relation’ i behandlingsrelationsservicens treatmentRelationRequestBody. |
| treatment.relation.followup.relations | Kommasepareret liste af kategorier, der indsættes som ’FollowupRelations/Relation’ i behandlingsrelationsservicens treatmentRelationRequestBody. |
| consent.issuer | Issuer til HSUID header bruges i kald til MinSpærring |
| consent.responsibleOrganization | Responsible organisation til brug i HSUID header. |
| app.name | Applikationsnavn |
| app.name.short | Kort applikationsnavn. |
| app.endpoint | Endpoint til brug i DKS servlet. |
| sor.oid | OID for sor. Skal være urn:oid:1.2.208.176.1.1. |
| alive.failThreshold | Antal på hinanden fejlende kald til henholdsvis cave, MinLog, MinSpærring og behandler relation før servicens health url returnerer HTTP status 500. |
| code.system.oid.substance | Det foretrukne OID system for substance koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:2.16.840.1.113883.6.73 |
| code.system.oid.patient | Det foretrukne OID system for patient koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:1.2.208.176.1.2 |
| code.system.oid.recorder | Det foretrukne OID system for recorder koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:1.2.208.176.1.3 |
| code.system.oid.recorder.org | Det foretrukne OID system for recorder organization koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:1.2.208.176.1.1 |
| code.system.oid.manifestation | Det foretrukne OID system for manifestation koden i CAVE servicen. Anvendes i forbindelse med mapning fra LAR til CAVE format, hvis flere records er tilgængelige. F.eks. urn:oid:1.2.208.176.2.4.12 |
| code.system.oid.drugId | OID for drug id. F.eks. urn:oid:1.2.208.176.2.4.12 |
SLA-logning på LAR Service sker ved hjælpe af SLALoggingServletFilter konfigureret som et servlet filter.
Konfiguration af SLA-log findes i filen nspslalog-lar.properties samt den Log4j fil der står i nspslalog-lar.properties.
Log4j konfiguration findes i pack /wildfly8/modules/sds/larservice/configuration/main/log4j.properties.
Bemærk at for at message id fra DGWS kan logges så er det vigtigt at ConversionPattern i log4j.properties indeholder %X{MESSAGE_ID}. Se evt. det leverede eksempel i compose/configuration.
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.