Introduktion

Formål

Dette dokument er rettet mod systemadministratorer og driftspersoner, som skal kunne håndtere driftsmæssige aspekter af EMC® Documentum® xDB Version 10.5.

Der henvises til XDB Manual hvor dette er relevant.

Komponentens afhængigheder, installation og konfiguration er beskrevet i SDS XDB Installationsvejledning.

Driftsvejledningen indeholder supplerende information om EMC® Documentum® xDB Version 10.5 med hensyn til:

Afhængighed af andre services (relevant i master-replica setups beskrevet i kapitel 14 i XDB Manual)
Placering af logfiler
Overvågning af xDB services
Genstart of service (hvis komponenten ikke er responsiv)
Oprettelse af database
Sletning af database
Backup
Genskabelse fra backup

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	07.11.2017	KvalitetsIT	Initiel udgave

Definitioner og referencer

Definition

Beskrivelse

NSP

National Service Platform

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

xDB er en (XML) database og kræver som sådan ikke tilstedeværelsen for andre service.

Der er mulighed for at starte xDB som en federation med en master server (til servicering af skriveoperationer) og een til flere replica nodes (til servicering af læseoperationer).

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

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.