Introduktion

Formål

Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere driftsmæssige aspekter af FSK Registry Adapter.

Driftsvejledningen indeholder information om komponenten 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 komponenten beskrevet dens forventede placering med hensyn til platform.

Afsnit 4 beskriver aktuelle konfigurationsparametre for komponenten samt eksempler på konfigurationsparameter-filer.

I afsnit 5 beskrives hvorledes FSK Registry Adapter 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 komponenten 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 i forbindelse med den initielle udviklings af komponenten.

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

Komponenten

FSK Registry Adapter komponenten kan beskrives som følger:

FSK Registry Adapter
Type: Webservice
Filnavn: fskregistry.war
Url: <serverurl>/fskregistry
Helbredsurl: <serverurl>/fskregistry/health

Daglig drift

Dette afsnit beskriver den daglige drift af systemet.

Database

FSK Registry Adapter anvender en database til persistering og afhentning af metadata. Denne database ejes imidlertid af en anden komponten: FSK Repository. Det er FSK Repository komponentens ansvar at beskrive backupprocedurer for databasen.

Relaterede services

FSK Registry Adapter afhænger af:

FSK Repository komponentens database

Ved fejl i forbindelse til denne denne vil FSK Registry Adapter returnere svar til anvendere, hvoraf det fremgår, at der er fejl.

Konfiguration

Opsætningen for FSK Registry Adapter sker i propertyfilen fskreg.properties.

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/sds/fskregistry/configuration/

Et eksempel på sådan konfiguration er:

documentEntry.title=TestTitle

documentEntry.mimeType=text/xml
documentEntry.languageCode=da-DK

documentEntry.patient.assigningAuthority.root=1.2.208.176.1.2
documentEntry.organisation.assigningAuthority.root=1.2.208.176.1.1

documentEntry.homeCommunityId=1.2.3.7.8
documentEntry.repositoryUniqueId=3.4.6.7

documentEntry.confidentialityCode.code=N
documentEntry.confidentialityCode.schemeName=2.16.840.1.113883.5.25
documentEntry.confidentialityCode.name=Normal

documentEntry.healthcareFacilityTypeCode.code=22232009
documentEntry.healthcareFacilityTypeCode.schemeName=2.16.840.1.113883.6.96
documentEntry.healthcareFacilityTypeCode.name=hospital

documentEntry.practiceSettingCode.code=408443003
documentEntry.practiceSettingCode.schemeName=2.16.840.1.113883.6.96
documentEntry.practiceSettingCode.name=almen medicin

documentEntry.classCode.code=001
documentEntry.classCode.schemeName=1.2.208.184.100.9
documentEntry.classCode.name=Klinisk rapport

documentEntry.formatCode.code=urn:ad:dk:medcom:appointmentsummary:full
documentEntry.formatCode.schemeName=1.2.208.184.100.10
documentEntry.formatCode.name=DK Appointment Summary Document schema

documentEntry.eventCode.code=39289-4
documentEntry.eventCode.schemeName=2.16.840.1.113883.6.1
documentEntry.eventCode.name=Dato og tidspunkt for møde mellem patient og sundhedsperson

documentEntry.typeCode.code=39289-4
documentEntry.typeCode.schemeName=2.16.840.1.113883.6.1
documentEntry.typeCode.name=Dato og tidspunkt for møde mellem patient og sundhedsperson

documentEntry.author.organisation.id=291000016008
documentEntry.author.organisation.name=Region Test

#documentEntry.patient.assigningAuthority.name=CPR

Properties beskrives ifølge tabel:

Property	Beskrivelse
documentEntry.title	CDA dokumentets titel, som returneret i metadata ved ITI-18 søgning
documentEntry.mimeType	CDA dokumentets mimetype, som returneret i metadata ved ITI-18 søgning
documentEntry.languageCode	CDA dokumentets mimetype, som returneret i metadata ved ITI-18 søgning
documentEntry.patient.assigningAuthority.root	CDA dokumentets patient identifier assigning authority OID, som returneret i metadata ved ITI-18 søgning
documentEntry.organisation.assigningAuthority.root	CDA dokumentets organisations identifier assigning authority OID, som returneret i metadata ved ITI-18 søgning
documentEntry.homeCommunityId	CDA dokumentets homecommunityid, som returneret i metadata ved ITI-18 søgning
documentEntry.repositoryUniqueId	CDA dokumentets repositoryid, som returneret i metadata ved ITI-18 søgning
documentEntry.confidentialityCode.code, schemaName, name	CDA dokumentets confidentiality code (code, schema og navn), som returneret i metadata ved ITI-18 søgning
documentEntry.healthcareFacilityTypeCode.code, schemaName, name	CDA dokumentets healthcarefacility code (code, schema og navn), som returneret i metadata ved ITI-18 søgning
documentEntry.practiceSettingCode.code, schemaName, name	CDA dokumentets practiceSetting code (code, schema og navn), som returneret i metadata ved ITI-18 søgning
documentEntry.classCode.code, schemaName, name	CDA dokumentets classCode code (code, schema og navn), som returneret i metadata ved ITI-18 søgning
documentEntry.formatCode.code, schemaName, name	CDA dokumentets format code (code, schema og navn), som returneret i metadata ved ITI-18 søgning
documentEntry.eventCode.code, schemaName, name	CDA dokumentets eventcode code (code, schema og navn), som returneret i metadata ved ITI-18 søgning
documentEntry.typeCode.code, schemaName, name	CDA dokumentets typecode code (code, schema og navn), som returneret i metadata ved ITI-18 søgning
documentEntry.author.organisation.id	CDA dokumentets author instituion id som returneret i metadata ved ITI-18 søgning
documentEntry.author.organisation.id	CDA dokumentets author instituion navn som returneret i metadata ved ITI-18 søgning

Som det fremgår af navnene ovenfor anvendes disse properties til at udfylde DocumentEntries ved søgninger mod FSK Registry. DocumentEntry metadata værdierne bør koordineres og opsættes, så de passer med CDA værdierne, der returneres i dokumenterne fra FSK Repository.

Derudover anvendes parametrene til at afgøre, om FSK Registry skal returnere data ved forspørgsler eller ej.

Hvis der f.eks. medsendes et søgeparameter i søgningen (ITI-18) på eventCode, så skal søgeværdien matche med værdien documentEntry.eventCode.code for, at der returneres en DocumentEntry for den pågældende borger.

Der filtreres på classCodes, typeCodes, eventCodes, confidentialityCodes og formatCodes modsvarer lignende navne i søge-parametre efter følgende opskrift:

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.

Konfiguration af log4j

Log4j konfiguration findes i følgende fil:

log4j.properties

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/sds/fskregistry/configuration/

Eksempel på konfiguration:

log4j.rootCategory=INFO, FILE
log4j.logger.dk.sds=DEBUG

log4j.appender.FILE=org.apache.log4j.RollingFileAppender
log4j.appender.FILE.File=${jboss.server.log.dir}/fsk-registry.log
log4j.appender.FILE.Append=true
log4j.appender.FILE.MaxFileSize=100MB
log4j.appender.FILE.MaxBackupIndex=10
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=%d [%-2p] %c - %m%n

Udpegning af SLA-log konfiguration

Følgende fil udpeger hvilken fil, der indeholder konfigurationen af SLA-logning:

log4j-nspslalog-fskreg.properties

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/sds/fskregistry/configuration/

Per default udpeges konfigurationsfilen beskrevet i næste afsnit.

Konfiguration af SLA-log

Per default indlæses konfigurationen af FSK Registry SLA-logning fra følgende fil:

nspslalog-fskreg.properties

Denne indlæses fra WildFly modulet:

/pack/wildfly8/modules/sds/fskregistry/configuration/

HTTP Status- og versionscheck på FSK Registry Adapter

HTTP Statuscheck er i FSK Registry Adapter lagt sammen med HTTP Versionsnummerinformation

Efter konfiguration og deploy af FSK Registry Adapter kan versionsnummer hentes med:

curl localhost:9090/fskregistry/health

hvilket giver output i stil med:

Version: 1.0.0

Overvågning

FSK Registry overvåges af Status og versionstjek URL.

Standard fejlsøgning

Fejlsøgning kan ske ved at undersøge de logfiler, der er beskrevet i forudgående afsnit.

Krav til backup

Det anbefales, at aktuelle konfigurationsfiler til FSK Registry holdes under versionskontrol og back-up.

Backup af databasen sorterer under FSK Repository (andet system)