Introduktion

Formål

Vejledning til installation og konfiguration af standardproduktet EMC® Documentum® xDB Version 10.5.

Der henvises til XDB Manual hvor dette er relevant.

Læsevejledning

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

Dokumenthistorik

Definitioner og referencer

Krav til miljø

Krav til operativsystem

xDB produktet kan køre på både Linux og Windowsbaserede operativsystemer (se XDB Manual sider 49-59).

De leverede installationsscripts kræver dog, at det underliggende operativsystem er af typen Ubuntu 16.04 eller tilsvarende.

Krav til adgang til andre services

i XDB Manual nævnes præ-installtionskravene (s 49) - mere specifikt krav til JVM.

Installationsscripts sørger for installations af disse.

Krav til datahåndtering

xDB produktet er en XML database, der gemmer (XML) dokumenter og/eller disses metadata. xDB anvender det underliggende filsystem til persisteringen. 

For en mere detaljeret beskrivelse henvises til XDB Manual side 45-46.

Som en del af installationsscriptet for xDB er det muligt at konfigurere den sti, hvor selve databasen ligger.

Der skal naturligvis etableres en backup procedure for datakataloget på filsystemet.

Krav til hardware

xDB ressourceforbrug (pladsforbrug) vil afhænge af flere parametre:

• Størrelsen af de dokumenter der gemmes
  
• Antallet af dokumenter der gemmes samtidig

Derudover servicerer xDB klienter (i dette tilfælde OpenText XDS Repository og/eller OpenText XDS Registry.

Kravene til processorkraft og memory vil være betinget af f.eks.

• Antallet af samtidige forespørgsler
• Kompleksiteten af de enkelte forespørgsler
• Mængden af data, som de enkelte forespørgsler giver anledning til som input henholdsvist output

Deployment på Ubuntu 16.04

Dette afsnit beskriver deploymentprocessen på Ubuntu 16.04.

Deployment dækker i dette tilfælde over installationen af xDB basissoftwaren og dennes afhængigheder samt opsætningen af xDB som en Systemd service.

Installation af xDB basissoftware og afhængigheder

Dette emne er beskrevet i kapitel 3 i XDB Manual.

Som en del af leverancen er der leveret installationsscripts til dette (se rollen roles/xdb i pakken med installationsscripts).

Installation af xDB Systemd service

Installationen af xDB som en Systemd service er leveret som en del af installationsscripts (se rollen roles/xdb i pakken med installationsscripts).

Konfiguration af komponenterne

Al konfiguration foregår ved redigering af de relevante properties filer i deres modul folder under WildFly modules. Ved konfigurationsændringer bør servicen/WildFly genstartes.

Indholdet af de enkelte konfigurationsfiler, er beskrevet og forklaret i [Driftsvejledning].

Følgende filer kan tilpasses:

application.properties

Konfigurerer opsætning af DRS og hvorledes den benytter sig af eksterne services.

En skabelon for denne fil findes i:

<packing>/drs/proxy/config/application.properties

Filen redigeres inden den placeres på WildFly i:

/pack/wildfly8/modules/sds/drs/configuration/main/

Yderligere information kan findes i driftsvejledningen.

log4j.properties

Konfigurerer logopsætningen for DDS Repository.

En skabelon for log4j konfiguration findes i:

<packing>/drs/proxy/config/log4j.properties

Filen redigeres inden den placeres på WildFly i:

/pack/wildfly8/modules/sds/drs/configuration/main/

Bemærk at Wildfly ikke benytter sig af log4j til logning, hvilket betyder at log4j specifikke egenskaber ikke kan anvendes som brugen af ISO8601 formatet.

Konfiguration af NSP SLA log

Konfigurerer logopsætningen for DDS Repository.

En skabelon for SLA logkonfiguration findes i projektet under:

/drs/proxy/slalog-example

Filerne nspslalog-DRS.properties og log4j-nspslalog-DRS.properties redigeres (evt) inden den placeres på WildFly i:

/pack/wildfly8/modules/sds/drs/configuration/main/

Start/genstart af service

Komponenten kan genstartes ved ”touch” af war-filen på WildFly. Alternativt skal WildFly genstartes ved at køre kommandoen

/etc/init.d/wildfly8 restart

Logfiler

Alle logs er beskrevet i driftsvejledningen.

Opgradering af komponenter

Når der kommer opgraderinger til en komponent, vil der medfølge en releasenote, der beskriver hvad opgraderingen består af, samt hvilke handlinger der er nødvendige for at opgradere den deployede komponent.

Afinstallation af servicen

Fjern service komponenter under WildFly’ deployments/ folder:

drs.war

Fjern properties filer under modules folder:

/pack/wildfly8/modules/sds/drs/configuration/main/

Fjern eventuelt logfiler – se afsnit 3.