Page History
...
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
...
- 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
...
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
...
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/
...
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.