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 Repository Version 1.9. Der findes standarddokumentation leveret sammen med softwaren af OpenText. OpenText henviser til administrationsguiden XDS Repository Administration Guide).

Placering af basissoftware, konfigurationsfiler og logfiler sker vha installationsscripts og er behandlet i SDS XDS Repository 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 Repository komponenten.
• XDS Repository 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 Repository komponenten.

Læsevejledning

Det forudsættes at læseren har kendskab til Linux (Ubuntu 16.04), Java og scriptingsproget Ansible.

Dokumenthistorik

Definitioner og referencer

Daglig drift

Dette afsnit beskriver den daglige drift af systemet.

Relaterede services

XDS Repository afhænger af, at dens database xDB er tilgængelig ved opstart.

Hvis dette ikke er tilfældet, vil XDS Repository 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 Repository, 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 Repository service (se nedenfor for vejledning).

Derudover har XDS Repository en afhængighed til et XDS Registry. Dette konfigureres som en del af installationsproceduren. XDS Repository holder ikke connections til registry som var tilfældet for xDB beskrevet ovenfor. I forbindelse med kald til ProvideAndRegisterDocumentSet servicen på XDS Repository vil dette lave et ITI-42 indexeringskald til registry. Hvis registry ikke er tilgængeligt, vil XDS Repository returnere en fejl til kalderen, men efterfølgende kald vil gå igennem, så snart at registry er tilgængeligt igen.

Overvågning

Til at tjekke, om XDS Repository er oppe kan passende anvendes den URL, hvor WSDL filen udstilles: https://hostnavn/repository/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 Repository.

Logfiler

XDS Repository logger til følgende områder:

• Applikationslog
• Auditlog
• SLA log

For en beskrivelse af dette se SDS XDS Repository 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 Repository Installationsvejledning for placering af denne logfil). Applikationsfejl vil derfor fremgå af denne log.

• XDS Repository 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 Repository 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 Repository 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 Repository både applikationslog og auditlog. Det anbefales at lave periodisk backup af auditloggen. I forbindelse hermed kan gamle (rullede) logfiler evt, fjernes fra XDS Repository driftsmiljøet.

Applikationslogs kan slettes, når det skønnes forsvarligt i forhold til support og fejlsøgning (f.eks. efter 14 dage).