Introduktion
Formål
Vejledning til installation og konfiguration af FSK Registry Adapter.
Afsnit 2 indeholder servicekrav til det omliggende miljø, herunder krav til operativsystem og standardapplikationer, som f.eks. applikationsservere, Java og/eller Net versioner mm., angivet på version og service pack-niveau.
Afsnit 3 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, f.eks. om applikationsserver og/eller databaseserver skal være stoppet.
Læsevejledning
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.
Dokumentet beskriver ikke forhold der berører konfiguration på DoDi, NSP eller centrale ’NSP-lignende miljøer’ eller etablering og konfiguration af distribution af data fra DoDi til øvrige platforme.
Hvor der i teksten er angivet <packing> refereres til topniveaufolderen for release-pakken med kildekode. Folderens navngivning afhænger af versionen på releaset.
Definitioner og referencer
Definition | Beskrivelse |
---|---|
DDS | Dokumentdelingsservice |
NSI | National Sundheds-IT |
NSP | Den nationale service platform (inden for sundheds-IT) |
XDS | Cross-Enterprise Document Sharing |
Driftsvejledning | FSK Registry Adapter - Driftsvejledning |
Krav til miljø
Krav til applikationsservere
Komponenterne er udviklet og testet under WildFly-8.2.0.Final i Docker.
Komponenternes konfiguration er tilpasset deployering på WildFly 8.2 applikationsservere.
Applikationsserveren kræver Java 8.
Krav til operativsystem
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.
Krav til adgang til andre services
FSK Registry Adapter læser og skriver i FSK Repositorys database.
Krav til database
Komponenten er testet mod MySQL Version 5.5.60 i Docker.
Krav til datahåndtering
FSK Registry Adapter behandler og opbevarer (via FSK Repositorys database) personhenførbare informationer. Det handler om metadata for CDA dokumenter af typen stamkort.
Krav til hardware
Aftaleoversigt FSK Registry Adapter ressourceforbrug vil afhænge af følgende:
Antallet af dokumenter der hentes samtidig
Deployment på Wildfly 8.2
Dette afsnit beskriver deploymentprocessen på WildFly 8.2.
I nuværende kode-base er følgende profiler forberedt:
Profilnavn | Profildefinitioner | Deployeringssti |
---|---|---|
conf | fskregistry-war/src/test/conf | sds/fskregistry/configuration |
NB! Deployeringsstien er relativ til <Wildfly>/modules/nsi.
Deployment af komponenter
OBS! Inden opstart af WildFly skal det sikres at properties og modul filer til servicen ligger i de applikationsspecifikke modul foldere på WildFly.
<packing>/fskregistry-war/target/fskregistry.war
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.
Konfiguration af datasource
FSK Registry Adaptor anvender en MySQl som database for mapning mellem cprnummer, formatcode, typecode og dokumentid.
Denne datasources slås op via JNDI. Datasourcen kan konfigureres i Wildfly ved at deploye filen i
/pack/wildfly8/standalone/deployments/fsk-ds.xml
Et eksempel kan findes i:
<packing>/fskregistry/fskregistry-war/src/test/installation/fsk-ds.xml
Konfiguration af komponenterne
Al konfiguration, undtagen 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 FSK Registry Adapter - Driftsvejledning.
Filer beskrevet i det følgende kan tilpasses.
Deployment af modul
WildFly module for FSK Registry Adapter sættes op ved at kopiere filen:
<packing>/fskregistry/fskregistry-war/src/test/conf → /pack/wildfly8/modules/sds/fskregistry/configuration/main/
Konfiguration af FSK Registry Adapter
fskreg.properties
En skabelon for denne fil findes i:
<packing>/fskregistry-war/src/test/conf/fskreg.properties
Filen redigeres inden den placeres på WildFly i:
/pack/wildfly8/modules/sds/fskregistry/configuration/main/
Yderligere information kan findes i FSK Registry Adapter - Driftsvejledning.
log4j-fskregistry-ws.xml og log4j.properties
Konfigurerer logopsætningen for FSK Registry Adapter.
Skabeloner for log4j konfiguration findes i:
<packing>/fskregistry-war/src/test/conf/log4j-fskregistry-ws.xml <packing>/fskregistry-war/src/test/conf/log4j.properties
Filen redigeres inden den placeres på WildFly i:
/pack/wildfly8/modules/sds/fskregistry/configuration/main/
Konfiguration af NSP SLA log
NSP-util anvendes som en del af servicen og skal konfigureres. Eksempel på konfiguration-fil findes i:
<packing>/fskregistry-war/src/test/conf/ log4j-nspslalog-fskreg.properties nspslalog-fskreg.properties
Filerne redigeres inden de placeres på WildFly i:
/pack/wildfly8/modules/sds/fskregistry/configuration/main/
Yderligere information kan findes i FSK Registry Adapter - Driftsvejledning
Logfiler
FSK Registry Adapter 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.
Opgradering af komponenter
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.
Afinstallation af servicen
Fjern service-komponenter under WildFly’ deployments/ folder:
fskregistry.war
Fjern properties filer under Aftaleoversigt XDS Adaptere modul-foldere:
/pack/wildfly8/modules/sds/fskregistry/configuration/main/
Fjern eventuelt logfiler.