Page History
...
Driftsvejledningen indeholder supplerende information om EMC® Documentum® xDB Version 10.5 med hensyn til:
- Relaterede services: Afhængighed af andre services (relevant i master-replica setups beskrevet i kapitel 14 i XDB Manual)
- Logfiler: 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
...
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 |
SLF4J | Facade til Java logning (se https://www.slf4j.org/) |
Daglig drift
Dette afsnit beskriver den daglige drift af systemet.
...
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
En replica server er afhængig af, at master serveren kører, for at den kan fungere.
Logfiler
Som standard loggers til stdout. Dette kan ændres ved at konfiguere en SLF4J opsætning. Se side 286 i XDB Manual.
Installationsscripts skal i så fald udvides med en logningskonfiguration (eksempel er at finde i XDB Manual).
xDB har mulighed for at logge mere detaljeret f.eks. logning af alle indkommende beskeder (requests).
Dette er beskrevet på s. 78 i XDB Manual i afsnittet "RPC tracing". RPC tracing er disabled, men kan slåes til ved at sætte følgende systemparameter
Systemparameter | Beskrivelse | Default |
---|---|---|
XHIVE_RPC_TRACING_ON | Slår RPC tracing til, hvis den sættes = true | false |
XHIVE_RPC_TRACING_MODE | standard eller compact se XDB Manual | standard |
XHIVE_RPC_TRACING_FORMAT | text eller XML se XDB Manual | plain |
Da disse parametre er defineres som Java systemvariable er der mulighed for at sætte dem vha installationsscripts (se SDS XDB Installationsvejledning).
SLA-log konfiguration
Da xDB er en standardkomponent, er der ikke mulig at anvende NSP Util til SLA-logning.
Derimod vil RPC tracing (beskrevet ovenfor) kunne anvendes til dette formål. På s. 80 XDB Manual i afsnittet "Sending RPC trace output to console or file" gennemgås, hvorledes det er muligt at sende RPC output til en fil ved at sætte logning op på JVM niveau.
Eksempel fra output fra RPC tracing:
2009-07-31T15:57:50.262 com.xhive.trace.rpc FINEST thread-1 RemoteSession@15a6029 0 REQUEST_AUTHENTICATE 23 msecs 39 bytes sent 13 bytes received 127.0.0.1:1797 127.0.0.1:1794 primary requestAuthenticate(userName=Administrator,password=******, databaseName=MyDatabase,authSession=true,prechecked=false)
Overvågning af service
Til at kontrollere, om xDB er oppe anbefales det, at opsætte en periodisk test af, om xDB porten er tilgængelig.
Dette kan f.eks. klares vha et værktøj som telnet.
Der kan også opsættes overvågning af xDB Systemd servicen (se SDS XDB Installationsvejledning).
Test af versionsnummer
Dette er ikke muligt for xDB.
Genstart af service
xDB er installeret som en Systemd service (se SDS XDB Installationsvejledning), hvorfor anvendelse af systemctl kan anvendes til dette.
Konfiguration
Servicekonfiguration
Al servicekonfiguration sker via Ansible vha installationsscripts. Se SDS XDB Installationsvejledning for en gennemgang.
Standard fejlsøgning
Det skal tjekkes at afviklingen af Ansible installationsscripts ikke gav anledning til fejl.
xDB service kan gestartes som sædvanlig Systemd service
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.
...
Installationsscripts og konfigurationsfiler skal være under source control (SVN).
Derudover gemmer xDB data på disken. Backup af xDB data er er beskrevet i XDB Manual på s. 262.
- Backup kan foretages på SAN niveau, hvis xDB servicen stoppes imens (beskrevet under offline backup) eller
- ved at anvende de i xDB definerede backup tools (i tilfældet, hvor online backup ønskes). Se siderne 262-263 for en detaljeret beskrivelse af kommandolinjeværktøjerne xdb backup og xdb restore