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

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:

NB! Deployeringsstien er relativ til <Wildfly>/modules/nsi.

Konfiguration af Aftaleoversigt XDS Registry Adapter

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:

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>