Page History
Navitabs | ||||
---|---|---|---|---|
| ||||
Table of Contents |
---|
Introduktion
...
Definition | Beskrivelse |
---|---|
DDS | Dokumentdelingsservice |
NSI | National Sundheds-IT |
NSP | Den nationale service platform (inden for sundheds-IT) |
DODI | NSI platform til data opsamling og distribution |
XDS | Cross-Enterprise Document Sharing |
Driftsvejledning | Driftsvejledning Aftaleoversigt AO XDS Adaptere - Driftsvejledning |
Aftale RESTful snitflade | Bookplan SJ2 aftalepilot: Løsnings- og snitfladebeskrivelse, version 2, 27.04.2016 |
...
Forbindelsen mellem Aftaleoversigt XDS Repository Adapter og Bookplan RESTful-snitfladen skal være passende beskyttet, hvilket tillige gælder forbindelsen mellem Dokumentdelingsservicen og Aftaleoversigt XDS Repository Adapter.
Krav til database
Komponenten er testet mod MySQL Version 5.5.60 i Docker.
Krav til datahåndtering
Både Aftaleoversigt XDS Registry Adapter og Aftaleoversigt XDS Repository Adapter behanlder og opbevarer personhenførbare informationer.
For Aftaleoversigt XDS Registry Adapters vedkommende sker dette ved behandling af personhenførbare informationer hentet fra Bookplan RESTful-snitfladen.
Både Aftaleoversigt XDS Registry og Repository Adapters gemmer CDA dokumenter indeholdende personhenførbar information i et midlertidigt datalager og sender informationer fra dette tilbage til kalderen.
Krav til hardware
Aftaleoversigt XDS Repository Adapter’s ressourceforbrug vil afhænge af flere parametre:
...
Profilnavn | Profildefinitioner | Deployeringssti | main | **/main/* | ddsprojects/ao/*/config/main|
---|---|---|---|---|---|
rm | **/rm/* | ddsprojects/ao/*/config/rm | rn | **/rn/* | ddsprojects/ao/*/config/rn |
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. Se afsnit 3.2.
Folderen <installationspakke> forudsættes genereret og indeholdte filer potentielt tilpasset som beskrevet i afsnit Konfiguration af komponenterne.
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/target/ao-documentmetadataprovider-<profil-navn>.war |
...
<packing>/xdswrappers/documentprovider-war/target/ao-documentprovider-<profil-navn>.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 – se afsnit 3.3.
Oprettelse af databasen
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 profile,n f.eks. aoxdscache-rm. 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 anvender en MySQl som database for de dokumenter, der hentes fra det bagvedliggende bookplan system.
Begge moduler slår datasources op via JNDI. Datasourcen kan konfigureres i Wildfly ved at deploye filen i
Code Block |
---|
/pack/wildfly8/standalone/deployments/aoxdscache-ds.xml |
Et eksempel kan findes i:
Code Block |
---|
<packing>/xdswrappers/provider-cache/etc/example/aoxdscache-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.
...
WildFly moduler for Aftaleoversigt XDS adapterne sættes op ved at kopiere filerne:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/<profil-navn>/module.xml → /pack/wildfly8/modules/nsi/ddsprojects/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
Konfigurerer opsætningen af bookplan RESTful klienten for Aftaleoversigt XDS Repository Adapter.
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/<profil-navn>/AODocumentProvider.properties |
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.
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/<profil-navn>/<version-kode>/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
...
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/<profil-navn>/<version-kode>/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
...
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/<profil-navn>/<version-kode>/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.
log4j-ao-documentmetadataprovider-ws.xml
...
En skabelon for log4j konfiguration findes i:
Code Block |
---|
<packing>/xdswrappers/documentprovider-war/src/test/resources/<profil-navn>/log4j-ao-documentmetadataprovider-ws.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/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>
...
<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.
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/documentmetadataprovider-war/src/test/resources/<profil-navn> |
...
log4j-nspslalog-ao-documentmetadataprovider-ws.properties |
...
nspslalog-ao-documentmetadataprovider.properties |
Filerne redigeres inden de placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |
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
Aftaleoversigt XDS Adapter-komponenterne kan logge kald til følgende logs: En NSP-SLA-log, 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.
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:
Code Block |
---|
ao-documentmetadataprovider<profil-navn>.war
ao-documentprovider<profil-navn>.war |
Fjern properties filer under Aftaleoversigt XDS Adaptere modul-foldere:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentprovider/config/<profil-navn>/ |
Fjern eventuelt logfiler – se afsnit 3.4.