Page History
Navitabs | ||||
---|---|---|---|---|
| ||||
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Installationsvejledning
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
1 Introduktion
1.1 Formål
1.2 Læsevejledning
1.3 Dokumenthistorik
1.4 Definitioner og referencer
2 Krav til miljø
2.1 Krav til applikationsservere
2.2 Krav til operativsystem
2.3 Krav til adgang til andre services
2.4 Krav til datahåndtering
2.5 Krav til hardware
3 Deployment på WildFly 8.2
3.1 Deployment af komponenter
3.2 Konfiguration af komponenterne
3.2.1 Deployment af Modul
3.2.2 Konfiguration af Svareksponeringsservice XDS Registry Adapter
3.2.3 Konfiguration af Svareksponeringsservice XDS Repository Adapter
3.3 Start/genstart af service
3.4 Logfiler
3.5 Opgradering af komponenter
4 Af-installation af servicen
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Version | Dato | Ansvarlig | Beskrivelse |
---|---|---|---|
0.9 | 18.8.2016 | Systematic | Første udgave |
1.0 | 21.9.2016 | Systematic | Klargjort til release |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
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 |
Alias | Beskrivelse | ||||||
---|---|---|---|---|---|---|---|
| Driftsvejledning Svareksponeringsservice XDS-adapter, (SSE/11734/OHB/0017) |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
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 tilgængelig og indeholdte filer potentielt tilpasset som beskrevet i afsnit 3.2.
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/target/sxa-documentmetadataprovider.war |
...
<packing>/xdswrappers/documentprovider-war/target/sxa-documentprovider.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.
Optionelt kan der opsættes en stub service, som returnerer dokumenter ligesom laboratoriedatabanken. I dette tilfælde skal en ekstra servicekomponent deployeres til Wildfly.
Code Block |
---|
<packing>/labreportservicestub/labreportservicestub/target/labreportservicestub.war |
Yderligere information er at finde i driftsvejledningen.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Al konfiguration, undtagen udpegning af log4j-konfigurationsfilen (se afsnit 3.2.2.5 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.
Wiki Markup
Indholdet af de enkelte konfigurationsfiler er beskrevet og forklaret i \[Driftsvejledning\].
Filer beskrevet i det følgende kan tilpasses.
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
WildFly moduler for Svareksponeringsservice XDS adapterne sættes op ved at kopiere filerne:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/module.xml |
...
-> |
...
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main |
...
---------------------------------------------------------------------------- |
...
<packing>/xdswrappers/documentprovider-war/src/test/resources/module.xml |
...
-> |
...
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Konfigurerer opsætning af dokument-metadata anvendt af Svareksponeringsservice XDS Registry Adapter.
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/sxametadataconfiguration.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main |
Yderligere information kan findes i driftsvejledningen.
...
Konfigurerer opsætning af, hvordan Svareksponeringsservice 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/sxafilterconfiguration.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main |
Yderligere information kan findes i driftsvejledningen.
...
Filen konfigurerer mapningen mellem søgeparametre for dokumentdeling og specialer fra Svareksponeringsservicen. En færdig skabelon findes i:
Code Block |
---|
<packing>/xdswrappers/provider-common/src/test/resources/sxapracticesettingcodes.xml |
Filen placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main |
Yderligere information kan findes i driftsvejledningen.
...
Konfigurerer logopsætningen for Svareksponeringsservice XDS Registry Adapter.
En skabelon for log4j konfiguration findes i:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/log4j-sxa-documentmetadataprovider-ws.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main |
Den tilhørende fil:
Code Block |
---|
<packing>/xdswrappers/documentmetadataprovider-war/src/test/resources/log4j.dtd |
kopieres ligeledes til:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main |
I det følgende vises hvordan standalone.xml opdateres med logging profile konfigurationen specifikt til Svareksponeringsservice XDS Registry Adapter, men opsætningen er også mulig igennem WildFly Administration Console. Konfigurationen er udelukkende til stede for at Svareksponeringsservice XDS Registry Adapters egen log4j logning virker, men er ikke sat op til at blive brugt, hvilket fremgår af at konfigurationen af level er sat til OFF.
Code Block |
---|
<logging-profile name="sxa-metadataprovider-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> |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
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 sxa-documentmetadataprovider.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 Svareksponeringsservice XDS Registry Adapter's modul på WildFly.
...
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/ |
...
log4j-nspslalog-sxa-documentmetadataprovider-ws.properties |
...
nspslalog-sxa-documentmetadataprovider.properties |
Filerne redigeres inden de placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main |
Yderligere information kan findes i driftsvejledningen.
...
Filen konfigurerer parametre anvendt ved kald af Svareksponeringsservicen. En skabelon findes i:
Code Block |
---|
<packing>/xdswrappers/documentprovider-war/src/test/resources/SXADocumentProvider.properties |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main |
Yderligere information kan findes i driftsvejledningen.
sxaproviderconfiguration.xml
Konfigurerer metadata opsætning af Svareksponeringsservice XDS Repository Adapter.
En skabelon for denne fil findes i:
Code Block |
---|
<packing>/xdswrappers/documentprovider-war/src/test/resources/sxaproviderconfiguration.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main |
Yderligere information kan findes i driftsvejledningen.
...
Filen konfigurerer mapningen mellem søgeparametre for dokumentdeling og specialer fra Svareksponeringsservicen. En færdig skabelon findes i:
Code Block |
---|
<packing>/xdswrappers/provider-common/src/test/resources/sxapracticesettingcodes.xml |
Filen placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main |
Yderligere information kan findes i driftsvejledningen.
Anchor | ||||
---|---|---|---|---|
|
Konfigurerer logopsætningen for Svareksponeringsservice XDS Repository Adapter.
En skabelon for log4j konfiguration findes i:
Code Block |
---|
<packing>/xdswrappers/documentprovider-war/src/test/resources/log4j-sxa-documentprovider-ws.xml |
Filen redigeres inden den placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main |
Den tilhørende fil::
Code Block |
---|
<packing>/xdswrappers/documentprovider-war/src/test/resources/log4j.dtd |
kopieres ligeledes til:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main |
I følgende vises hvordan standalone.xml opdateres med logging profile konfigurationen specifikt til Svareksponeringsservice XDS Repository Adapter, men opsætningen er også mulig igennem WildFly Administration Console. Konfigurationen er udelukkende til stede for at Svareksponeringsservice XDS Repository Adapters egen log4j logning virker, men er ikke sat op til at blive brugt (hvilket fremgår af, at konfigurationen af level er sat til OFF).
Code Block |
---|
<logging-profile name="sxa-provider-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> |
Anchor | ||||
---|---|---|---|---|
|
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 sxa-documentprovider.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 Svareksponeringsservice XDS Repository Adapter's modul på WildFly.
...
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/ |
...
log4j-nspslalog-sxa-documentprovider.properties |
...
nspslalog-sxa-documentprovider.properties |
Filerne redigeres inden de placeres på WildFly i:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main |
Yderligere information kan findes i driftsvejledningen.
...
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 |
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Svareksponeringsservice 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.4, 3.2.2.6, 3.2.3.4 og 3.2.3.6.
Alle logs er beskrevet i \[Driftsvejledning\].
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
Anchor | ||||
---|---|---|---|---|
|
...
Fjern service-komponenter under WildFly' deployments/ folder:
Code Block |
---|
sxa-documentmetadataprovider.war |
...
sxa-documentprovider.war |
Fjern properties filer under Svareksponeringsservice XDS Adaptere modul-foldere:
Code Block |
---|
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentmetadataprovider/config/main |
...
/pack/wildfly8/modules/nsi/ddsprojects/sxa/documentprovider/config/main |
Fjern eventuelt logfiler – se afsnit 3.4.