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
Version | Dato | Ansvarlig | Beskrivelse |
0.1 | 7.11.2017 | KvalitetsIT | Initiel version |
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 |
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
Dog er en række mindstekrav listet i XDB Manual s. 50.
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).
Installationsscriptet antager, at de bineære xDB filer ligger som en fil på den host, hvor basissoftwaren ønskes installeret.
En sådan er leveret med sammen med installationsscriptsene i SVN (xDB_10_5_11.tar).
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 afvikling af Ansible scripts. Det er således ikke meningen, at der skal foregå en manuel konfigurering på driftsmiljøerne.
Installationsscriptsene kan aktivere den relevante konfiguration ved anvendelse af Ansible Inventories.
For xDB kan man således påvirke konfigurationen af xDB ved følgende Ansible variable:
| Konfigurationsparameter | Beskrivelse | Defaultværdi |
|---|---|---|
| xdb_page_size | Page size i bytes (se XDB Manual s. 77) | 0 |
| xdb_server_port | Det portnummer, hvor xDB servicen modtager connections (XDB Manual s. 60) | 1235 |
| webserver_running | Skal der startes en (intern) web server til anvendelse af administrativ web grænseflade? (XDB Manual s. 60 og s. 246) | N |
| other_hosts_connect | Tillade connections fra andre hosts (XDB Manual s. 60) | Y |
| server_jvm_initial_memory_xms | Initiel allokering af hukommelse til xDB serverens JVM (XDB Manual s. 60) | |
| server_jvm_max_memory_xmx | Maksimal allokering af hukommelse til xDB serverens JVM (XDB Manual s. 60) | |
| number_of_cache_pages | Antal sider, der caches i memory (XDB Manual s. 60) | |
| client_jvm_initial_memory_xms | Initiel allokering af hukommelse til xDB klientens JVM (XDB Manual s. 60) | |
| client_jvm_max_memory_xmx | Maksimal allokering af hukommelse til xDB klientens JVM (XDB Manual s. 60) | |
| extra_java_options | Evt. ekstra options til JVM | |
| xdb_tar | Placeringen af xDB basissoftwarepakken | {{installation}}/xdb.tar |
Start/genstart af service
xDB servicen startes, stoppes, genstartes osv. efter gældende brug af Systemd service management:
- Start: systemctl start xdb
- Stop: systemctl stop xdb
- Genstart: systemctl restart xdb
- Status: systemctl status xdb
Logfiler
For beskrivelse af logning se SDS XDB Driftsvejledning.
Opgradering af komponenter
Ved opgradering af xDB basissoftwaren skal de tilhørende release notes gennemgåes med henblik på at afdække evt. ændringer i forhold til installation og/eller konfiguration.
Hvis der ikke er ændringer i forhold til dette er det tilstrækkeligt med en erstatning af basissoftware pakken (xdb_tar) og en gentagelse af installationsscripts.
Afinstallation af servicen
Der er ikke leverert scripts til dette. Antagelsen er, at den (virtuelle) host, hvor xDB er installeret nedlægges.