Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Driftsvejledningen indeholder information om EMC ® Documentum® XDS Registry Repository 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 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 Registry Repository komponenten.
  • XDS Registrys 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 Registry Repository 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

09.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 Repository afhænger af, at dens database xDB er tilgængelig ved opstart.

Hvis dette ikke er tilfældet, vil XDS Registry 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 RegistryRepository, da den ikke er i stand til at få genskabt connections til databasen.

...

Problemer med database connections vil kunne afhjælpes ved en genstart af XDS Registry Repository service (se nedenfor for vejledning).

Overvågning

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

...

Dette er ikke implementeret for XDS RegistryRepository.

Logfiler

XDS Registry Repository logger til to filer: Applikationslog og auditlog (for en beskrivelse af dette se SDS XDS Registry 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:

...

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

  • Applikationsloggen er default opsat til at logge på niveau INFO (se SDS XDS Registry Repository Installationsvejledning for placering af denne logfil). Applikationsfejl vil derfor fremgå af denne log.

  • XDS Registry 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 Registry Repository servicen startes, stoppes, genstartes osv. efter gældende brug af Systemd service management for tomcat7 servicen:

...

Det anbefales at aktuelle konfigurationsfiler er under versionskontrol og backup.

XDS Registry 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 Registry 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 Registry Repository driftsmiljøet.

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