Page History
...
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
...
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.
...
OBS! Inden opstart af WildFly skal det sikres at properties og modul filer til servicen ligger i de applikationsspecifikke modul foldere på WildFly.
Code Block |
---|
<packing>/xdswrappers/documentmetadataproviderfskregistry-war/target/ao-documentmetadataprovider-<profil-navn>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.
...
Aftaleoversigtens XDS Registry og XDS Repository har brug for en MySql database til persistering og hentning af dokumenter.
Der skal opsættes en MySQL database med en tilhørende bruger. Navnet på databasen kan f.eks. reflektere profilen f.eks. aoxdscache-rm henholdsvist aoxdscache-rn. De forskellige installationer kan også anvende samme db instans, da der udover selve dokumentet persisteres repository id og homecommunityid.
Når databasen er oprettet skal følgende scripts køres mod MySQL (i den nævnte rækkefølge):
Code Block |
---|
<packing>/xdswrappers/provider-cache/etc/sql/01_aoxdscache_create_tables.sql |
Konfiguration af datasource
Både Aftaleoverisgt XDS Registry og Repository FSK Registry Adaptor anvender en MySQl som database for de dokumenter, der hentes fra det bagvedliggende bookplan system.mapning mellem cprnummer og dokumentid.
Denne datasources slås Begge moduler slår datasources op via JNDI. Datasourcen kan konfigureres i Wildfly ved at deploye filen i
Code Block |
---|
/pack/wildfly8/standalone/deployments/aoxdscachefsk-ds.xml |
Et eksempel kan findes i:
Code Block |
---|
<packing>/xdswrappersfskregistry/providerfskregistry-cachewar/src/etctest/exampleinstallation/aoxdscachefsk-ds.xml |
Konfiguration af komponenterne
Al konfiguration, undtagen udpegning af log4j-konfigurationsfilen (se afsnit 3.2.2.4 og 3.2.3.5), 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 moduler for Aftaleoversigt XDS adapterne module for FSK Registry Adapter sættes op ved at kopiere filernefilen:
Code Block |
---|
<packing>/xdswrappersfskregistry/documentmetadataproviderfskregistry-war/src/test/resources/<profil-navn>/module.xmlconf → /pack/wildfly8/modules/nsisds/ddsprojectsfskregistry/ao/documentmetadataprovider/config/<profil-navn>/ <packing>/xdswrappers/documentprovider-war/src/test/resources/<profil-navn>/module.xml → /pack/wildfly8/modules/nsi/ddsprojects/ao/documentprovider/config/<profil-navn>/ |
Konfiguration af Aftaleoversigt XDS Registry Adapter
AODocumentProvider.properties
...
configuration/main/ |
Konfiguration af FSK Registry Adapter
fskreg.properties
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataproviderfskregistry-war/src/test/resources/<profil-navn>/AODocumentProviderconf/fskreg.properties |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsisds/ddsprojectsfskregistry/ao/documentmetadataprovider/config/<profil-navn>configuration/main/ |
Yderligere information kan findes i driftsvejledningen.
cda_document_template.xml
Skabelon til brug under transformering af Bookplan aftaler til CDA dokumenter.
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/cda_document_template.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |
aometadataconfiguration.xml
Konfigurerer opsætning af dokument-metadata anvendt af Aftaleoversigt XDS Registry Adapter.
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/<profil-navn>/aometadataconfiguration.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |
Yderligere information kan findes i driftsvejledningen.
aofilterconfiguration.xml
Konfigurerer opsætning af, hvordan Aftaleoversigt XDS Registry Adapter skal reagere på søge-parametre givet ved dokumentmetadata-forespørgsler.
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/aofilterconfiguration.xml |
Bemærk at ovenstående fil ikke er placeret under en profil.
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |
Yderligere information kan findes i driftsvejledningen.
...
findes i FSK Registry Adapter Driftsvejledning.
log4j-fskregistry-ws.xml
Konfigurerer logopsætningen for Aftaleoversigt XDS FSK Registry Adapter.
En skabelon for log4j konfiguration findes i:
Code Block |
---|
<packing>/xdswrappers/documentproviderfskregistry-war/src/test/resourcesconf/<profil-navn>/log4j-ao-documentmetadataproviderfskregistry-ws.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsisds/ddsprojectsfskregistry/ao/documentmetadataprovider/config/<profil-navn>/ |
I det følgende vises hvordan Standalone.xml opdateres med logging profile konfigurationen specifikt til Aftaleoversigt XDS Registry Adapter, men opsætningen er også mulig igennem WildFly Administration Console.
Konfigurationen er udelukkende til stede for at Aftaleoversigt XDS Registry Adapters egen log4j logning virker, men er ikke sat op til at blive brugt som ses ved konfigurationen af level til OFF.
Code Block |
---|
<logging-profile name="ao-metadataprovider-<profil-navn>-logging-profile">
<size-rotating-file-handler name="PerformanceFile" autoflush="true">
<level name="OFF"/>
</size-rotating-file-handler>
<logger category="performancelogger" use-parent-handlers="false">
<level name="OFF"/>
<handlers>
<handler name="PerformanceFile"/>
</handlers>
</logger>
</logging-profile> |
Udpegning af log4j-konfigurationsfilen
Filen beskrevet i afsnit 3.2.2.3 udpeges som konfigurationsfil for log4j i filen:
Code Block |
---|
documentsharing.log4j.properties |
under roden i war-filen ao-documentmetadataprovider-<profil-navn>.war, der er placeret som beskrevet i afsnit 3.1. Bemærk, at denne fil (om nødvendigt) skal tilpasses direkte i war-filen og ikke findes under Aftaleoversigt XDS Registry Adapter’s modul på WildFly.
configuration/main/ |
Konfiguration af NSP SLA log
NSP-util anvendes som en del af servicen og skal konfigureres. Eksempel på konfiguration-fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataproviderfskregistry-war/src/test/resourcesconf/<profil-navn> log4j-nspslalog-ao-documentmetadataprovider-wsfskreg.properties nspslalog-ao-documentmetadataproviderfskreg.properties |
Filerne redigeres inden de placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsisds/ddsprojectsfskregistry/aoconfiguration/documentmetadataprovider/config/<profil-navn>/main/ |
Yderligere information kan findes i driftsvejledningen.
Konfiguration af Aftaleoversigt XDS Repository Adapter
aoproviderconfiguration.xml
Konfigurerer metadata opsætning af Aftaleoversigt XDS Repository Adapter.
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentprovider-war/src/test/resources/<profil-navn>/aoproviderconfiguration.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentprovider/config/<profil-navn>/ |
Yderligere information kan findes i driftsvejledningen.
log4j-ao-documentprovider-ws.xml
Konfigurerer logopsætningen for Aftaleoversigt XDS Repository Adapter.
En skabelon for log4j konfiguration findes i:
Code Block |
---|
<packing>/xdswrappers/documentprovider-war/src/test/resources/<profil-navn>/log4j-ao-documentprovider-ws.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentprovider/config/<profil-navn>/ |
I følgende vises hvordan Standalone.xml opdateres med logging profile konfigurationen specifikt til Aftaleoversigt XDS Repository Adapter, men opsætningen er også mulig igennem WildFly Administration Console. Konfigurationen er udelukkende til stede for at Aftaleoversigt XDS Repository Adapters egen log4j logning virker, men er ikke sat op til at blive brugt som ses ved konfigurationen af level til OFF.
Code Block |
---|
<logging-profile name="ao-provider-<profil-navn>-logging-profile">
<size-rotating-file-handler name="PerformanceFile" autoflush="true">
<level name="OFF"/>
</size-rotating-file-handler>
<logger category="performancelogger" use-parent-handlers="false">
<level name="OFF"/>
<handlers>
<handler name="PerformanceFile"/>
</handlers>
</logger>
</logging-profile> |
Udpegning af log-4j-konfigurationsfilen
Filen beskrevet i afsnit 3.2.3.3 udpeges som konfigurationsfil for log4j i filen:
Code Block |
---|
documentsharing.log4j.properties |
under roden i war-filen ao-documentprovider-<profil-navn>.war, der er placeret som beskrevet i afsnit 3.1. Bemærk, at denne fil (om nødvendigt) skal tilpasses direkte i war-filen og ikke findes under Aftaleoversigt XDS Repository Adapter’s modul på WildFly.
Konfiguration af NSP SLA-log
NSP-util anvendes som en del af servicen og skal konfigureres. Eksempel på konfiguration-fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentprovider-war/src/test/resources/<profil-navn>
log4j-nspslalog-ao-documentprovider-ws.properties
nspslalog-ao-documentprovider.properties |
Filerne redigeres inden de placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentprovider/config/<profil-navn>/ |
Yderligere information kan findes i driftsvejledningen.
Start/genstart af service
Komponenterne kan genstartes ved ”touch” af de respektive war-filer på WildFly. Alternativt skal WildFly genstartes ved at køre kommandoen:
Code Block |
---|
/etc/init.d/wildfly8 restart |
Logfiler
FSK Registry Adapter Driftsvejledning
Logfiler
FSK Registry Adapter Aftaleoversigt XDS Adapter-komponenterne kan logge kald til følgende logs: En NSP-SLA-log , og en applikationslog og eventuelt en performancelog.
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 i afsnit 3.2.2.3, 3.2.2.4, 3.2.3.3 og 3.2.3.5.ovenfor.
Alle logs er beskrevet i driftsvejledningen.
...
Fjern service-komponenter under WildFly’ deployments/ folder:
Code Block |
---|
ao-documentmetadataprovider<profil-navn>.war ao-documentprovider<profil-navn>fskregistry.war |
Fjern properties filer under Aftaleoversigt XDS Adaptere modul-foldere:
Code Block |
---|
/pack/wildfly8/modules/nsisds/ddsprojectsfskregistry/ao/documentmetadataprovider/config/<profil-navn>/ /pack/wildfly8/modules/nsi/ddsprojects/ao/documentprovider/config/<profil-navn>/configuration/main/ |
Fjern eventuelt logfiler – se afsnit 3.4.