Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Definitioner og referencer

DefinitionBeskrivelse
DDSDokumentdelingsservice
NSINational Sundheds-IT
NSPDen nationale service platform (inden for sundheds-IT)
XDSCross-Enterprise Document Sharing
Driftsvejledning
Driftsvejledning
FSK Registry Adapter Driftsvejledning


Krav til miljø

Krav til applikationsservere

...

I nuværende kode-base er følgende profiler forberedt:

ProfilnavnProfildefinitionerDeployeringssti
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.