Skriptbasiertes Update auf DWH-J2EE-1.0 für Debian (und CentOS)

Für laufende DWH-Instanzen auf Debian-Servern stellen wir ein Update-Skript bereit, zu finden unter Debian Update Paket. Für die Ausführung ist wichtig, dass der User als root angemeldet ist. Dazu führt man, falls der User auf der Sudoer-Liste steht (der User root hat dann meist kein eigenes Passwort), folgendes aus:

sudo su -

oder, wenn der User nicht auf der Sudoer-Liste steht (root hat eigenes Passwort), folgendes:

su -

Als erstes muss das Paket heruntergeladen und entpackt werden:

wget http://www.aktin.org/software/repo/org/aktin/dwh/dwh-update/1.0/dwh-update-1.0.tar.gz
tar xvzf dwh-update-1.0.tar.gz
cd dwh-update

Der Inhalt (ls) sollte dann etwa wie folgt aussehen:

dwh-update
- aktin.properties
- aktin_dwh_update.sh
- email.config
- email_config_reset.sh
- README.md
- lib/
- - ...

Das Updateskript kann wie folgt ausgeführt werden:

./aktin_dwh_update.sh

Seit dem Update 0.7 werden einige wichtige Einstellungen in der Datei aktin.properties abgespeichert. Sollten Sie diese Datei noch nicht angepasst und in den entsprechenden Ordner kopiert haben, werden Sie in der Konsole darauf hingewiesen und das Skript wird unterbrochen. In dem Fall folgen Sie bitte die Anweisungen unter “Lokale Konfigurationen in der Datei aktin.properties”.

Ebenfalls seit dem Update 0.7 wird eine lokale E-Mailadresse verwendet, um Berichte und Meldungen an die Nutzer zu versenden. Sollte noch keine E-Mail eingestellt sein oder Sie Probleme mit dem Versenden der E-Mails haben, folgen Sie bitte die Anweisungen unter “E-Mail-Konfiguration und Änderungen”.

Der Update besteht aus 6 Schritten. In der Konsole werden während des Updates die Schritte und Informationen sowie eventuelle Fehlermeldungen ausgegeben. Am Ende des Skriptes wird der Wildfly-Server neugestartet und das neue Softwarepaket bereitgestellt. Abhängig von der Serverleistung kann dies mehrere Minuten dauern. Bei erfolgreicher Installation kommt folgende Meldung:

+++SUCCESS+++ EAR successfully deployed after xxx sec

Häufige Fehler

Sollte die Bereitstellung bis Skriptende immer noch nicht fertiggestellt sein, kommt folgende Fehlermeldung:

+++WARNING+++ file not successfully deployed, check for file: dwh-j2ee-1.0.ear.deployed

Dies muss kein Fehler sein. Das Script wartet nur zwei Minuten und gibt dann die Warnung aus. Bitte überprüfen Sie nach einigen Minuten den Deployment-Ordner /opt/wildfly-9.0.2.Final/standalone/deployments, z.B. mit dem Befehl

ls /opt/wildfly-9.0.2.Final/standalone/deployments/dwh-j2ee-*.deployed

Sollte eine Datei angezeigt werden, war das Update erfolgreich.

Test der Verbindung und E-Mail-Konfiguration

Unter dem Link http://IHRSERVER/aktin/admin/plain/test.html kann man die oben durchgeführten Anpassungen nun testen.

Eine weiterführende Anleitung zum Testen der Verbindung finden Sie auf der Seite Installationsskript im Bereich “Test der Betriebsfähigkeit”.

Lokale Konfigurationen in der Datei `aktin.properties`

Die Datei aktin.properties muss für jeden Standort individuell angepasst werden. Dies ist nur nötig, wenn bei einem Update neue Angaben in der Properties-Datei erforderlich sind (z.B. bei Version 1.0). Ihre bisher in der Datei hinterlegten Angaben werden bei einem Update übernommen.

Mit dem unten stehenden Befehl können Sie die Datei bearbeiten, sofern Sie sich im dwh-update-Ordner befinden (andernfalls navigieren Sie wieder in das Verzeichnis, in dem Sie zuvor das Update-Skript ausgeführt haben).

nano aktin.properties

Ein Template sowie weiterführende Erläuterungen zu wichtigen Einstellungen finden Sie auf der Seite Installationsskript im Bereich “Aktin-Properties”.

Nach Bearbeiten der Datei muss diese in den Konfigurationsordner des Wildfly-Servers kopiert werden, im Normalfall unter /opt/wildfly-9.0.2.Final/standalone/configuration/.

cp aktin.properties /opt/wildfly-9.0.2.Final/standalone/configuration/

Sollte später die Einstellung geändert werden, muss man dies direkt in dem Wildfly-Konfigurationsordner machen, im Normalfall unter /opt/wildfly-9.0.2.Final/standalone/configuration/ zu finden. Starten Sie im Anschluss den Wildfly-Service neu:

nano /opt/wildfly-9.0.2.Final/standalone/configuration/aktin.properties
service wildfly stop
service wildfly start

Zurück

E-Mail-Konfiguration und Änderungen

Bitte tragen Sie in der Datei email.config die E-Mail-konfigurationen für die Ausgangsmailadresse ein. Diese Adresse wird für Benachrichtigungen und Berichte hausintern verwendet. Dies sollte eine dedizierte E-Mail-Adresse (Dienstkonto mit festem Passwort) sein. Eine funktionstüchtige E-Mail-Adresse ist Voraussetzung für dieses Update.

nano email.config

Ein Template und weiterführende Erläuterungen der Parameter finden Sie auf der Seite Installationsskript im bereich “E-Mail-Konfiguration”.

Sollten Sie bereits E-Mail eingerichtet haben und möchten diese nun ändern, müssen die folgenden Schritte zusätzlich durchgefführt werden:

Als erstes muss das Skript ./email_config_reset.sh aus dem Updateordner mit root-Rechten ausgeführt werden. Nach dem Bearbeiten der email.config führt man das Updateskript ./aktin_dwh_update.sh wieder mit root aus.

Zurück

Aktin Diagnose-Skript

Sollten Probleme beim automatischen Update auftreten, so führen Sie bitte das Aktin-Diagnose-Skript aus. Eine genauere Beschreibung finden Sie auf der Seite Installationsskript im Bereich “Aktin Diagnose-Skript”.

Senden Sie diese Datei bitte an den Aktin-Support, unter it-support(at)aktin.org, mit einer Support-Anfrage. Die erzeugten Logs helfen bei der Identifizierung von Problemen.

AKTIN : DWH Server