Vejledning til installation og konfiguration af LAR.
Vejledningen indeholder servicekrav til det omliggende miljø, herunder krav til operativsystem og standardapplikationer, som f.eks. applikationsservere, Java version mm., angivet på version og service pack-niveau.
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 og Ubuntu Linux operativ system.
Hvor der i teksten er angivet <packing> refereres til topniveaufolderen for release-pakken med kildekode. Folderens navngivning afhænger af versionen på releaset.
Definition | Beskrivelse |
|---|---|
| LAR | Lægemiddelallergiregisrering |
| SDS | Sundhedsdatastyrelsen |
| NSP | Den nationale service platform (inden for sundheds-IT) |
| Driftsvejledning | LAR Driftsvejledning |
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, ud over krav om, at Java er understøttet på operativsystemet.
Ubuntu Linux bruges som operativsystem på NSP’en, og udviklingen af komponenten er foretaget på Ubuntu 16.04.
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.
Dette afsnit beskriver deploymentprocessen på WildFly 8.2.
I nuværende kode-base er følgende profiler forberedt:
Profilnavn | Profildefinitioner | Deployeringssti |
|---|---|---|
| conf | larservice-war/src/test/conf | sds/larservice/configuration |
NB! Deployeringsstien er relativ til <Wildfly>/modules/sds.
OBS! Inden opstart af WildFly skal det sikres at properties og modul filer til servicen ligger i de applikationsspecifikke modul foldere på WildFly.
|
Servicekomponenter der skal deployes til WildFly, skal kopieres til mappen ”deployments”. Hvis WildFly kører normalt starter den selv komponenten op. Er dette ikke tilfældet skal WildFly genstartes.
Al konfiguration foregår ved redigering af de relevante properties filer under WildFly modules. Ved konfigurationsændringer bør servicen/WildFly genstartes.
Indholdet af de enkelte konfigurationsfiler, er beskrevet og forklaret i LAR Driftsvejledning.
Filer beskrevet i det følgende kan tilpasses.
WildFly module for LAR Service sættes op ved at kopiere filen:
|
En skabelon for denne fil findes i:
|
Filen redigeres inden den placeres på WildFly i:
|
Yderligere information kan findes i LAR Driftsvejledning.
Konfigurerer logopsætningen for LAR.
En skabelon for log4j konfiguration findes i:
|
Filen redigeres inden den placeres på WildFly i:
|
Konfiguration af NSP SLA log
NSP-util anvendes som en del af servicen og skal konfigureres. Eksempel på konfiguration-fil findes i:
|
Filerne redigeres inden de placeres på WildFly i:
|
Yderligere information kan findes i LAR Driftsvejledning.
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/ |
| 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 = true | Angiver om integration med samtykke er slået til. Skal altid være true i produktion. |
| samtykke.endpoint | Endpoint til MinSpærring. |
| minLog.enabled | Angiver om integration til min log er slået til. Skal være true i produktion. |
| minLog.endpoint | Endpoint til min log. |
| 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 min log, min spæ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=dk.nsi.larservice | ID navn til brug i whitelist database. |
| idcard.min.sec.level=4 | Minimum security level på id kort. Skal være 4 i produktion. NO_AUTHENTICATION = 1 |
| log.config.file=log4j.properties | 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 = Lar service | |
| consent.responsibleOrganization = Kvalitets Drift | |
| app.name = LAR service | Applikationsnavn |
| app.name.short = LAR | Kort applikationsnavn. |
| app.endpoint=http://localhost:8090/lar | |
| sor.oid = urn:oid:1.2.208.176.1.1 | |
| alive.failThreshold = 5 | Antal på hinanden fejlende kald til henholdsvis cave, MinLog, MinSpærring og behandler relation før servicens health url returnerer HTTP status 500. |
LAR kan logge kald til følgende logs: En NSP-SLA-log og en applikationslog.
I default opsætningen logges udelukkende fejl til applikationsloggen.
Det er muligt at konfigurere placeringen af filerne, samt hvilket niveau de logger på, ved at redigere i filerne beskrevet ovenfor.
Alle logs er beskrevet i driftsvejledningen.
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.
Fjern service-komponenter under WildFly’ deployments/ folder:
|
Fjern properties filer under modul-folderen:
|
Fjern eventuelt logfiler.