Page History
...
Driftsvejledningen indeholder information om EMC ® Documentum® XDS Registry Version 1.9. Der findes standarddokumentation leveret sammen med softwaren af OpenText. OpenText henviser til administrationsguiden for EMC ® Documentum® XDS Repository Version 1.9 (se XDS Repository Administration Guide), da de to produkter i driftsmæssig forstand er sammenlignelige.
Placering af basissoftware, konfigurationsfiler og logfiler sker vha installationsscripts og er behandlet i SDS XDS Registry Installationsvejledning.
I dette dokument findes information om følgende:
- Relaterede services: Eksterne afhængigheder og evt. krav til genstart af applikationer hvis komponenten ikke er responsiv.
- Overvågning af XDS Registry komponenten.
- XDS Registrys logfiler beskrives så disse evt. kan overvåges, og tillige danne baggrund for fejlsøgning.
- Beskrivelse af standard fejlsøgning og start.
- Start/stop vejledning for komponenten findes tillige i dette .
- Backupkrav i forhold til XDS Registry komponenten.
Læsevejledning
Det forudsættes at læseren har kendskab til Linux (Ubuntu 16.04), Java og scriptingsproget Ansible.
...
Definition | Beskrivelse |
NSP | Den nationale service platform (inden for sundheds-IT) |
Installationsscripts | De i dokumentet omtalte installationsscripts er at finde på SVN under: https://svn.nspop.dk/svn/kvalitetsit/xdsinfrastruktur |
Komponenter
Dette dokument dækker følgende komponenter på NSP:
...
Dokumentregistreringsservice
...
Type: Webservice
...
Filnavn: drs.war
...
Url: <serverurl>/drs
...
Servicecheckurl: <serverurl>/drs/health
...
DRS komponenten anvender desuden Aftale XDS Repository.
Daglig drift
Dette afsnit beskriver den daglige drift af systemet.
Relaterede services
DRS XDS Registry afhænger af tilstedeværelsen af andre services, og ved fejl i disse vil DRS fejle tilsvarende. Disse services er:
Aftale XDS Repository
Konfiguration
DRS
Servicekonfiguration
Grundlæggende konfiguration foregår ved redigering i filen application.properties der placeres i følgende WildFly modul:
/pack/wildfly8/modules/sds/drs/configuration/main/
Moduldefinitionen er at finde i sourcekoden til drs under:
/proxy/config/module.xml
I filen skal følgende properties være definerede:
...
Property
...
Beskrivelse
...
environment
...
Værdien skal være én af følgende development/production
Værdien afgør, hvorvidt SOSITestFederation eller SOSIFederation anvendes.
...
dgwsheaders.remove
...
Værdien skal være én af følgende: true/false
Angiver, om DGWS headers skal fjernes fra SOAP beskeden inden denne proxies videre til Aftale XDS Repository
...
backend.url
...
Adressen på Aftale XDS Repositorys iti-41 endpoint
, at dens database xDB er tilgængelig ved opstart.
Hvis dette ikke er tilfældet, vil XDS Registry starte op i en fejltilstand og senere kald mod databasen vil gå galt.
Ligeledes vil en genstart af den underliggende xDB kræve en efterfølgende genstart af XDS Registry, da den ikke er i stand til at få genskabt connections til databasen.
Det anbefales at overvåge applikationsloggen for fejl på niveau ERROR. F.eks. linjer som denne:
13:23:17.181 [http-nio-8443-exec-1] com.emc.healthcare.xds.registry.commons.AbstractRegistryProcessor ERROR c.e.h.x.r.c.AbstractRegistryProcessor - Exception during RegisterDocumentSetProcessor processing
java.lang.RuntimeException: Failed to get xdb session
Problemer med database connections vil kunne afhjælpes ved en genstart af XDS Registry service (se nedenfor for vejledning).
Overvågning
Til at tjekke, om XDS Registry er oppe kan passende anvendes den URL, hvor WSDL filen udstilles: https://hostnavn/registry/services/
Derudover vil det være relevant at overvåge applikationsloggen for entries på niveau ERROR. F.eks. vil forbindelsesproblemer til databasen kunne findes her og afhjælpes ved en genstart af komponenten.
Test af versionsnummer
Dette er ikke implementeret for XDS Registry.
Logfiler
XDS Registry logger til to filer: Applikationslog og auditlog (for en beskrivelse af dette se SDS XDS Registry Installationsvejledning).
Som nævnt ovenfor kan det give mening at overvåge applikationsloggen f.eks. med henblik på at diagnosticere forbindelsesproblemer til databasen. Et eksempel fra loggen vedr. netop databaseforbindelser ser således ud:
13:23:17.181 [http-nio-8443-exec-1] com.emc.healthcare.xds.registry.commons.AbstractRegistryProcessor ERROR c.e.h.x.r.c.AbstractRegistryProcessor - Exception during RegisterDocumentSetProcessor processing
java.lang.RuntimeException: Failed to get xdb session
Standard fejlsøgning
Applikationsloggen er default opsat til at logge på niveau INFO (se SDS XDS Registry Installationsvejledning for placering af denne logfil). Applikationsfejl vil derfor fremgå af denne log.
XDS Registry er installeret på en dedikeret Apache Tomcat, som er installeret som en Systemd service (se ovenfor for information om, hvordan der kan interageres med denne).
Start/genstart af service
XDS Registry servicen startes, stoppes, genstartes osv. efter gældende brug af Systemd service management for tomcat7 servicen:
- Start: systemctl start tomcat7
- Stop: systemctl stop tomcat7
- Genstart: systemctl restart tomcat7
- Status: systemctl status tomcat7
log4j konfiguration
Log4j konfiguration findes i samme wildfly modul som servicekonfigurationen
Se yderligere opsætning i installationsvejledningen.
SLA-log konfiguration
SLA-log konfigurationen lægges i samme wildfly modul som servicekonfigurationen.
Se yderligere opsætning i installationsvejledningen.
HTTP Statuscheck på DRS
Til statuscheck af DRS forefindes en health URL (se ovenfor)
Test af versionsnummer
Hvis helbredsURLen ovenfor tilgåes, så kan man se versionsnummeret:
{ version: "0.0.1-SNAPSHOT"}
Overvågning
DRS overvåges af en servicespecifik servicechecksnitflade, hvis url kan aflæses i afsnit 2.
Fortolkning af Health URL
Health URL returnerer enten status 200, hvis de i øjeblikket kører fint, status 404 hvis servicen ikke er deployeret.
Logfiler og fortolkning af disse
Konfigureres i log4j properties
Standard fejlsøgning
Ved problemer med indlæsning af servicens konfigurationsfil (application.properties) bør man verificere at filen ligger korrekt i wildfly modulet.
Ved manglende logning bør konfigurationsfilen (log4j.properties samt log4j-nspslalog.properties) checkes, da logindstillingerne sættes herigennem.
En service eller et job kan genstartes ved at kalde touch på den tilsvarende war-fil. I yderste konsekvens kan WildFly genstartes ved at bruge /etc/init.d/wildfly8 restart.
Krav til backup m.m.
Det anbefales at aktuelle konfigurationsfiler er under versionskontrol og back up.backup.
XDS Registry komponenten indeholder ikke selv klinisk data, da OpenText XDB anvendes som database. Det anbefales at lave periodisk backup af denne. Denne procedure er beskrevet i SDS XDB Driftsvejledning.
Derudover producerer XDS Registry både applikationslog og auditlog. Det anbefales at lave periodisk backup af auditloggen. I forbindelse hermed kan gamle (rullede) logfiler evt, fjernes fra XDS Registry driftsmiljøet.
Applikationslogs kan slettes, når det skønnes forsvarligt i forhold til support og fejlsøgning (f.eks. efter 14 dage).