Formålet med dette dokument er at beskrive hvordan installations- og konfigurationsscripts til xDB kan vedligeholdes og videreudvikles.
Dette dokument er en del af den samlede dokumentation for xDB. Denne er tilgængelig her: OpenText XDB.
Læser forventes at have kendskab til Ansible scripting sproget.
Hvor der i teksten er angivet <component base> refereres til topniveaufolderen for kildekoden for installations- og konfigurationsscripts.
Version | Dato | Ansvarlig | Beskrivelse |
Definition | Beskrivelse |
Scripts til installation og konfiguration af standardkomponenten xDB fra OpenText er implementeret i Ansible.
Scriptenes ansvar er fokuseret på installation og konfiguration af komponenten. Byg og pakning af basissoftwaren ligger udenfor dette, men en vejledning hertil kan findes i dokumentationen: OpenText XDB.
Afviklingen af scriptsene danner basis for beskrivelserne i dokumenterne SDS XDB Installationsvejledning og SDS XDB Driftsvejledning.
I det følgende antages at koden er hentet ned fra nspop SVN.
For at kunne afvikle installations- og konfigurationsscriptsene kræves Ansible version 2.2+.
Der henvises til installationsvejledningen SDS XDB Installationsvejledning for nærmere instrukser.
Under arbejdet med installations- og konfigurationsscripts kan det være en fordel løbende at afvikle dem mod en lokal virtuel maskine (se f.eks Download VirtualBox for Linux Hosts for at få en lokal Ubuntu instans).
Installations- og konfigurationsscripts er bygge op vha en rolle (se f.eks. Creating Reusable Playbooks).
Dette er valgt for at øge genbrugeligheden henover miljøerne. En konkret playbook kæder den genbrugelige rolle sammen med miljøspecifikke variable i inventories (se Variables Defined in Inventory).
Kildekoden er bygget op efter standard Ansible praksis. Bemærk at nedenstående er det udsnit af installations- og konfigurationsscripts, der angår xDB. Installationsscripts til XDS Registry og XDS Repository ligger i samme SVN, men disse beskrives andetsteds.
ansible
│ ├── inventories
│ │ ├── aws
│ │ ├── first-repository
│ │ ├── group_vars
│ │ │ ├── all
│ │ │ ├── local
│ │ │ ├── tomcat
│ │ │ └── udv
│ │ ├── host_vars
│ │ │ ├── local-xdb-registry-replica1
│ │ │ ├── local-xdb-repository-replica1
│ │ │ ├── udv-aws
│ │ │ └── udv-xds
│ │ ├── local
│ │ ├── local-test-topology
│ │ ├── local-xds
│ │ ├── local-xds-test
│ │ ├── staging
│ │ └── udv
│ ├── roles
│ │ ├── xdb
│ │ ├── defaults
│ │ │ └── main.yml
│ │ ├── tasks
│ │ │ └── main.yml
│ │ └── templates
│ │ ├── install-master.sh
│ │ ├── install-replica.sh
│ │ ├── xdb-master.service
│ │ └── xdb-replica.service
│ ├── xdb-registry.yml
│ └── xdb-repository.yml
Rollen xdb indeholder det, der skal til for at installere og konfigurere en instans af xDB. Rollen installere prerequisites for xDB og installerer xDB basissoftware som en systemd service.
Playbooks xdb-registry og xdb-registry anvender den generelle xdb rolle i konteksten af anvendelse for hhv XDS Registry og XDS Repository.
Endelig vises inventories hvordan variable skal sættes op for at konfiguration sættes efter specifikationen af konkrete miljøer.
Test af scripts foregår via driften, der tester det mod testmiljø. Hvis en afvikling af scriptet giver anledning til fejl, vil Ansible rapportere dette.