Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere driftsmæssige aspekter af komponenterne fra Aftaleoversigt XDS-adaptere.
Driftsvejledningen indeholder information om komponenterne med hensyn til eksterne afhængigheder, standard placering af logfiler og konfigurationsfiler, og evt. krav til genstart af applikationer hvis komponenten ikke er responsiv.
I afsnit 2 er beskrevet hvilke komponenter, der indgår i Aftaleoversigt XDS-adaptere og deres forventede placering med hensyn til platform.
Afsnit 4 beskriver aktuelle konfigurationsparametre for komponenterne i Aftaleoversigt XDS-adaptere, samt eksempler på konfigurationsparameter-filer.
I afsnit 5 beskrives hvorledes Aftaleoversigt XDS-adapter-komponenterne overvåges.
Beskrivelse af standard fejlsøgning og vejledning for start/stop af komponenterne er beskrevet i afsnit 6.
Specielle krav til backup er beskrevet i afsnit 7, ligesom procedure ved reetablering af komponenterne ud fra backup beskrives.
Læseren forventes at have kendskab til National Sundheds-IT’s platform NSP, samt generelt kendskab til WildFly applikationsserver samt Ubuntu Linux operativ system.
Dette dokument er oprettet med udgangspunkt i dokumentet OHB0016 Driftsvejledning Aftaleoversigt XDS-adaptere.docx
1.4. Definitioner og referencer
Definition | Beskrivelse |
|---|---|
| DDS | Dokumentdelingsservice |
| NSI | National Sundheds-IT |
| NSP | Den nationale service platform (inden for sundheds-IT) |
STS | Security Token Service |
XDS | Cross-Enterprise Document Sharing |
Flere konfigurationer af Aftaleoversigt XDS-adaptere kan være deployeret på samme Wildfly applikationsserver. Se beskrivelse af profiler og profil-navne i indledningen af afsnit 4.
Aftaleoversigt XDS-adaptere er implementeret gennem følgende komponenter:
Aftaleoversigt XDS Registry Adapter
Type: Webservice
Filnavn: ao-documentmetadataprovider-<profil-navn>.war
Url: <serverurl>/ao-documentmetadataprovider-<profil-navn>
Statusurl: <serverurl>/service-check/service?servicename=ao-documentmetadataprovider-<profil-navn>
Aftaleoversigt XDS Repository Adapter
Type: Webservice
Filnavn: ao-documentprovider-<profil-navn>.war
Url: <serverurl>/ao-documentprovider-<profil-navn>
Statusurl: <serverurl>/service-check/service?servicename=ao-documentprovider-<profil-navn>
Brug af service-check forudsætter følgende komponent på NSP:
Service-check
Type: Webservice
Filnavn: service-check.war
Url: <serverurl>/service-check/service
Dette afsnit beskriver den daglige drift af systemet.
Aftaleoversigt XDS Registry Adapter afhænger af den eksterne service:
Bookplans RESTful aftalesnitflade
Ved fejl i denne vil Aftaleoversigt XDS Registry Adapter returnere svar til anvendere, hvoraf det fremgår, at der er fejl.
Byg og deployering af Aftaleoversigt XDS-adaptere er forberedt, så flere instanser kan fungere på samme Wildfly applikationsserver på samme tid. Derved kan opsættes Aftaleoversigt XDS-adaptere til forskellige regioner eller forskellige instanser inden for samme region. Hver instans bygges og deployeres ved brug af en profil, som beskrevet herunder.
I nuværende kode-base er følgende profiler forberedt:
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.
Opsætningen for kalderen af bookplan servicen konfigueres i AODocumentProvider.properties.
Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |
Et eksempel på sådan konfiguration er:
ao.appointmentservice.request.timeout.seconds=120 ao.appointmentservice.request.username=username ao.appointmentservice.request.password=password ao.appointmentservice.connection.poolsize=10 ao.appointmentservice.endpoint=http://localhost:9090/appointmentsstub/search/appointments/V1 ao.document.assigning.authority.name=Region Nordjylland Aftaleoversigt ao.document.root.id=1.2.208.176.99.179.99.98.1.1 |
Properties beskrives ifølge tabel.
| Property | Beskrivelse |
|---|---|
ao.appointmentservice.request.timeout.seconds | Antal sekunder for hvor lang tid et request mod Bookplan servicen maximalt må tage før forsøget meldes som mislykket. |
ao.appointmentservice.request.username | Brugernavnet der anvendes ved kald til Bookplan |
ao.appointmentservice.request.password | Kodeordet der anvendes ved kald til Bookplan |
ao.appointmentservice.connection.poolsize | Maksimalt antal samtidige kald mod Bookplan servicen. |
ao.appointmentservice.endpoint | Url’en til Bookplan servicen |
| ao.document.assigning.authority.name | Navnet på oprindelssted for Bookplan data. |
ao.document.root.id | OID for oprindelssted af Bookplan data |
Dokument-metadata anvendt af Aftaleoversigt XDS Registry Adapter, når der laves opslag på en patient, er defineret i følgende fil:
aometadataconfiguration.xml
Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |
Et eksempel på indhold i aometadataconfiguration.xml:
<metadata> <classCode class="codedValue"> <code>001</code> <codeSystem>2.16.840.1.113883.3.4208.100.9</codeSystem> <description>Klinisk rapport</description> </classCode> <confidentialityCode class="codedValue"> <code>N</code> <codeSystem>2.16.840.1.113883.5.25</codeSystem> <description>Normal</description> </confidentialityCode> <formatCode class="codedValue"> <code>urn:ad:dk:medcom:appointmentsummary:full</code> <codeSystem>2.16.840.1.113883.3.4208.100.10</codeSystem> <description>DK Appointment Summary Document schema</description> </formatCode> <languageCode>da-DK</languageCode> <mimeType>text/xml</mimeType> <practiceSettingCode class="codedValue"> <code>Unknown</code> <codeSystem>2.16.840.1.113883.11.10612</codeSystem> <description>Unknown</description> </practiceSettingCode> <typeCode class="codedValue"> <code>39289-4</code> <codeSystem>2.16.840.1.113883.6.1</codeSystem> <description>Dato og tidspunkt for møde mellem patient og sundhedsperson</description> </typeCode> <homeCommunityId>1.2.208.176.99.179.99.98</homeCommunityId> <repositoryUniqueId>1.2.208.176.99.179.99.98.1</repositoryUniqueId> <uniqueIdRoot>1.2.208.176.99.179.99.98.1.1</uniqueIdRoot> <healthcareFacilityTypeCode class="codedValue"> <code>22232009</code> <codeSystem>1.2.208.176.1.1.2</codeSystem> <description>hospital</description> </healthcareFacilityTypeCode> <authorInstitution class="dk.nsi.documentsharing.core.metadata.model.OrganisationImpl"> <name>Region Nordjylland</name> <id class="valueWithAssigningAuthority"> <value>6071000016008</value> <assigningAuthority>1.2.208.176.1.1</assigningAuthority> </id> <address class="dk.nsi.documentsharing.core.metadata.model.AddressImpl"> <street>Niels Bohrs Vej 20</street> <postalCode>9220</postalCode> <city>Aalborg Øst</city> </address> <telecom class="dk.nsi.documentsharing.core.metadata.model.TelecomImpl"> <telecom>97 64 80 00</telecom> </telecom> </authorInstitution> </metadata> |
Ved opslag på en patient kan der anføres en række søge-parametre. Aftaleoversigt XDS Registry Adapter har logik, der er afhængig af konkrete søge-parametre og konfigureret filter (beskrevet her), fastlægger om den bagvedliggende bookplan service skal kaldes.
Filteret konfigureres i følgende fil:
aofilterconfiguration.xml
Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |
I konfiguration specificeres 0, 1 eller flere kode-sæt i hhv. classCodes, typeCodes, eventCodes, confidentialityCodes og formatCodes.
<filter> <classCodes> </classCodes> <typeCodes> </typeCodes> <eventCodes> </eventCodes> <confidentialityCodes> </confidentialityCodes> <formatCodes> </formatCodes> </filter> |
Hver kode-sæt, består af:
<codedValue> <code>kode-værdi</code> <codeSystem>kode-system</codeSystem> <description>menneskelæselig beskrivelse af kodeværdi</description> </codedValue> |
Filterets classCodes, typeCodes, eventCodes, confidentialityCodes og formatCodes modsvarer lignende navne i søge-parametre, der kan være anført ved kald af Aftaleoversigt XDS Registry Adapter opslag. Er et kodesæt anført i søge-parametre for fx eventCodes, da bevirker filteret et tomt svar, når:
Filterets eventCodes ikke er tomt, og
Ingen af evt. flere eventCodes fra søge-parametre findes i filterets eventCodes-liste
Tilsvarende logik er gældende de øvrige koder i filteret.
Følgende er et eksempel på konfiguration af filteret:
<filter> <classCodes/> <typeCodes> <codedValue> <code>39289-4</code> <codeSystem>2.16.840.1.113883.6.1</codeSystem> <description>Dato og tidspunkt for møde mellem patient og sundhedsperson</description> </codedValue> </typeCodes> <eventCodes/> <confidentialityCodes> <codedValue> <code>N</code> <codeSystem>2.16.840.1.113883.5.25</codeSystem> <description>Normal</description> </codedValue> </confidentialityCodes> </filter> |
Følgende fil, der findes under roden i war-filen ao-documentmetadataprovider-<profil-navn>.war, udpeger den fil, der anvendes til konfiguration af log4j:
documentsharing.log4j.properties
Bemærk, at denne fil (om nødvendigt) skal tilpasses direkte i war-filen og ikke findes i WildFly modulet.
Log4j konfiguration findes i følgende fil:
log4j-ao-documentmetadataprovider-ws.xml
Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |
I konfigurationen er det muligt at aktivere performanceloggeren, der udvalgte steder i adapteren, vil skrive tidsvarighed af kald igennem systemet. Performanceloggeren aktiveres ved at ændre level værdien fra ”OFF” til ”DEBUG”. Eftersom konfigurationen kun indlæses ved opstart af servicen, er det nødvendigt at genstarte servicen efter endt redigering af log4j-ao-documentmetadataprovider-ws.xml filen.
Eksempel på konfiguration af performanceloggeren, hvor level værdien er sat til ”OFF”:
<logger name="performancelogger" additivity="false"> <level value="OFF" /> <appender-ref ref="PerformanceFile" /> </logger> |
Som standard skriver performanceloggeren til ao-documentmetadataprovider-ws-performance.log i WildFly’ log-folder.
Se yderligere opsætning i installationsvejledningen.
Følgende fil udpeger hvilken fil, der indeholder konfigurationen af SLA-logning:
nspslalog-ao-documentmetadataprovider.properties
Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |
Per default udpeges konfigurationsfilen beskrevet i næste afsnit.
Per default indlæses konfigurationen af Aftaleoversigt XDS Registry Adapters SLA-logning fra følgende fil:
log4j-nspslalog-ao-documentmetadataprovider.properties
Denne indlæses fra WildFly modulet:
/pack/wildfly8/modules/nsi/ddsprojects/ao/documentmetadataprovider/config/<profil-navn>/ |