Introduktion

Formål

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

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.
  • Start/stop vejledning for komponenten. 
  • 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.

Dokumenthistorik

Version

Dato

Ansvarlig

Beskrivelse

0.1

08.11.2017

KvalitetsIT

Initiel udgave

Definitioner og referencer

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


Daglig drift

Dette afsnit beskriver den daglige drift af systemet.

Relaterede services

XDS Registry afhænger af, 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

Logning er opdelt i følgende områder:

  • Applikationslog
  • Auditlog
  • SLA log

For en beskrivelse af disse: 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

  • Det skal tjekkes at afviklingen af Ansible installationsscripts ikke gav anledning til fejl.

  • Applikationsloggen (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

Krav til backup m.m.

Det anbefales at aktuelle konfigurationsfiler er under versionskontrol og 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). 


  • No labels