Manualles Update auf DWH-J2EE-1.4 für Ubuntu



Anmelden als root

Für die Ausführung ist wichtig, dass der Nutzer als root angemeldet ist. Sollten Sie den Nutzer root noch nicht aktiviert haben, so folgen Sie bitte den Anweisungen im Abschnitt Erste Schritte des Installationsskriptes. Alle folgenden Befehle sollten nur als Nutzer root ausgeführt werden.

Deployment des neuen Softwarepaketes

Das neue Softwarepaket kann entweder dem geladenen Updatepaket entnommen werden (dwh-update/packages/dwh-j2ee-1.4.ear) oder unter EAR Release 1.4 heruntergeladen werden. Sofern Sie eine laufende Instanz des Wildlfy-Servers haben, stoppen Sie diese zunächst über folgenden Befehl:

service wildfly stop

Anschließend kann die heruntergeladene Datei in den Ordner deployments des Wildfly-Servers kopiert werden. Stellen Sie jedoch sicher, dass es sich bei Ihrer kopierten EAR-Datei um die einzige Datei mit dieser Endung handelt. Löschen Sie gegebenenfalls vor dem Kopieren sämtliche andere Dateien mit der Endung .ear aus dem Ordner.

rm /opt/wildlfy/standalone/deployments/*.ear*

cp dwh-update/packages/dwh-j2ee-1.4.ear /opt/wildlfy/standalone/deployments/

Patch der aktin.properties

Mit der neuen Version 1.4 wurden einige neue Schlüssel der aktin.properties hinzugefügt. Diese werden im Rahmden des neuen Features, nämlich das Hochladen und den Import von stationären Behandlungsdaten, benötigt. Die drei neuen Schlüssel lauten

import.data.path=/var/lib/aktin/import
import.script.path=/var/lib/aktin/import-scripts
import.script.timeout=10800000

und können auf manuellem Wege über

nano /opt/wildfly/standalone/configuration/aktin.properties

oder über die Ausführung des beigelegten Patches

patch /opt/wildfly/standalone/configuration/aktin.properties < dwh-update/scripts/properties_file_import.patch

der aktin.properties hinzugefügt werden.

Ablegen des Importskripts für stationäre Behandlungsdaten

Für den Import von fallbasierten Daten gemäß §21 KHEntgG in das AKTIN DWH wird ein Importskript bereitgestellt. Um das Skript auch über den Data Warehouse-Manager nutzen zu können, muss dieses in einem festgelegten Ordner auf Ihrem System abgelegt werden. Der Ordnerpfad wird über den Schlüssel import.script.path aus der aktin.properties bezogen und lautet /var/lib/aktin/import-scripts. Erstellen Sie den Ordner und kopieren Sie das Importskript über folgende Befehle. Stellen Sie dabei auch sicher, dass sowohl der Ordner als auch das Skript dem Nutzer und der Gruppe wildfly zugeordnet sind.

mkdir -p /var/lib/aktin/import-scripts
chown wildfly:wildfly /var/lib/aktin/import-scripts

cp dwh-update/scripts/p21importer.py /var/lib/aktin/import-scripts/
chown wildfly:wildfly /var/lib/aktin/import-scripts/p21importer.py

Anpassen der maximalen Dateigröße für das Hochladen von Dateien

Um auch den Import von größeren Dateien zu ermöglichen, muss das Limit für die maximale Dateigröße in der Konfiguration des wilfly-Servers angepasst werden. Standardgemäß liegt dieser Wert bei 10 Megabyte. Mit folgendem Befehl setzen Sie die maximale Dateigröße auf 1 Gigybyte. Die Dateigröße wird dabei in Byte angegeben.

sed -i 's|enable-http2=\"true\"/>|enable-http2=\"true\" max-post-size=\"1073741824\"/>|' /opt/wildfly/standalone/configuration/standalone.xml

Wiederaufnahme des Betriebs

Starten Sie zum Abschluss den Wildfly-Server:

service wildfly start

Das Deployment wird damit automatisch gestartet und kann einige Minuten andauern. Nach erfolgereichem Deployment wird die Datei opt/wildlfy/standalone/deployments/dwh-j2ee-1.4.ear.deployed erstellt. Sie können dies mit folgendem Befehl kontrollieren:

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

Sollte die Datei angezeigt werden, war das Update erfolgreich. Sollte stattdessen /opt/wildfly/standalone/deployments/dwh-j2ee-1.4.ear.failed auftauchen oder ein anderer Fehler auftreten, so führen Sie bitte das AKTIN-Diagnose-Skript aus. Eine genauere Beschreibung finden Sie im Bereich AKTIN-Diagnose-Skript des Installationsskriptes.

Nach dem erfolgreichen Update können Sie auf der Seite http://<IHR SERVER>/aktin/admin/plain/test.html die Grundfunktionalität testen. Eine weiterführende Anleitung zum Testen der Verbindung finden Sie im Bereich Test der Betriebsfähigkeit.