Introduktion
Formål
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æsevejledning
Læseren forventes at have kendskab til National Sundheds-IT’s platform NSP, samt generelt kendskab til WildFly applikationsserver samt Ubuntu Linux operativ system.
Dokumenthistorik
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 |
Komponenter
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
Daglig drift
Dette afsnit beskriver den daglige drift af systemet.
Relaterede services
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.
Konfiguration
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.
Konfiguration af Aftaleoversigt XDS Registry Adapter
Konfiguration af dokument-metadata
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> |
|---|
Konfiguration af filter på dokument-metadata-forespørgsel
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> |
|---|
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> |
|---|