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æ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 i forbindelse med den initielle udviklings af komponenten.
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 |
FSK Registry Adapter komponenten kan beskrives som følger:
FSK Registry Adapter
Type: Webservice
Filnavn: fskregistry.war
Url: <serverurl>/fskregistry
Helbredsurl: <serverurl>/fskregistry/health
Dette afsnit beskriver den daglige drift af systemet.
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.
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.
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=Fælles stamkort 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.208.176.8.1.12 documentEntry.repositoryUniqueId=1.2.208.176.43210.8.10.12 documentEntry.healthcareFacilityTypeCode.code=554041000005106 documentEntry.healthcareFacilityTypeCode.schemeName=2.16.840.1.113883.6.96 documentEntry.healthcareFacilityTypeCode.name=sundhedsforvaltning documentEntry.classCode.code=001 documentEntry.classCode.schemeName=1.2.208.184.100.9 documentEntry.classCode.name=Klinisk rapport documentEntry.formatCode.code=DK FSK Schema documentEntry.formatCode.schemeName=urn:ad:dk:medcom:fsk:full documentEntry.formatCode.name=DK FSK Schema documentEntry.typeCode.code=52460-3 documentEntry.typeCode.schemeName=2.16.840.1.113883.6.1 documentEntry.typeCode.name=Patient Information documentEntry.author.organisation.id=634491000016008 documentEntry.author.organisation.name=Sundhedsdatastyrelsen documentEntry.practiceSettingCode.code=408443003 documentEntry.practiceSettingCode.schemeName=2.16.840.1.113883.6.96 documentEntry.practiceSettingCode.name=almen medicin documentEntry.confidentialityCode.code=N documentEntry.confidentialityCode.schemeName=2.16.840.1.113883.5.25 documentEntry.confidentialityCode.name=normal |
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.healthcareFacilityTypeCode.code, schemaName, name | CDA dokumentets healthcarefacility 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.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.
Den eneste property, der varierer fra miljø til miljø er angivelsen af repositoryUniqueId - resten er de samme henover miljøer.
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å healthcarefacility og formatCodes modsvarer lignende navne i søge-parametre efter følgende opskrift:
Filterets code ikke er tomt, og
Ingen af evt. flere koder fra søge-parametre findes i filterets
Tilsvarende logik er gældende de øvrige koder i filteret.
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 |
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.
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 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 |
FSK Registry overvåges af Status og versionstjek URL.
Fejlsøgning kan ske ved at undersøge de logfiler, der er beskrevet i forudgående afsnit.
Det anbefales, at aktuelle konfigurationsfiler til FSK Registry holdes under versionskontrol og back-up.
Backup af databasen sorterer under FSK Repository (andet system)