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:
Læsevejledning
Det forudsættes at læseren har kendskab til Linux (Ubuntu 16.04), Java og scriptingsproget Ansible.
Version | Dato | Ansvarlig | Beskrivelse |
0.1 | 07.11.2017 | KvalitetsIT | Initiel udgave |
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 |
Dette dokument dækker følgende komponenter på NSP:
Dokumentregistreringsservice
Type: Webservice
Filnavn: drs.war
Url: <serverurl>/drs
Servicecheckurl: <serverurl>/drs/health
Versionurl: <serverurl>/drs/health returnerer en json struktur med denne
DRS komponenten anvender desuden Aftale XDS Repository.
Dette afsnit beskriver den daglige drift af systemet.
DRS afhænger af tilstedeværelsen af andre services, og ved fejl i disse vil DRS fejle tilsvarende. Disse services er:
Aftale XDS Repository
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 findes i samme wildfly modul som servicekonfigurationen
Se yderligere opsætning i installationsvejledningen.
SLA-log konfigurationen lægges i samme wildfly modul som servicekonfigurationen.
Se yderligere opsætning i installationsvejledningen.
Til statuscheck af DRS forefindes en health URL (se ovenfor)
Hvis helbredsURLen ovenfor tilgåes, så kan man se versionsnummeret:
{ version: "0.0.1-SNAPSHOT"}
DRS overvåges af en servicespecifik servicechecksnitflade, hvis url kan aflæses i afsnit 2.
Health URL returnerer enten status 200, hvis de i øjeblikket kører fint, status 404 hvis servicen ikke er deployeret.
Konfigureres i log4j properties
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.
Det anbefales at aktuelle konfigurationsfiler er under versionskontrol og back up.