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.
Version | Dato | Ansvarlig | Beskrivelse |
0.1 | 7.11.2017 | KvalitetsIT | Initiel version |
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 |
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.
i XDB Manual nævnes præ-installtionskravene (s 49) - mere specifikt krav til JVM.
Installationsscripts sørger for installations af disse.
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.
xDB ressourceforbrug (pladsforbrug) vil afhænge af flere parametre:
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.
Dog er en række mindstekrav listet i XDB Manual s. 50.
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.
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).
Installationen af xDB som en Systemd service er leveret som en del af installationsscripts (se rollen roles/xdb i pakken med installationsscripts).
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:
For beskrivelse af logning se SDS XDB Driftsvejledning.
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.
Der er ikke leverert scripts til dette. Antagelsen er, at den (virtuelle) host, hvor xDB er installeret nedlægges.