Installationsprozess

Im Folgenden wird MariaDB als Datenbank genutzt.

Datenbank erstellen

Linux

In der Konsole in das Verzeichnis <Install-path>\<datenbank>\bin wechseln.
Bei MariaDB als Datenbank ist es das Verzeichnis <Install-path>\mariadb\bin
Den Befehl mysql.exe -u "username" -p ausführen
BASH
```
mysql -u root -p -h localhost
```
Wenn die Verbindung steht, die benötigte Datenbank erstellen (in der MariaDB-shell)
BASH
```
create database ece2;
```

Folgende Befehle, mit den entsprechenden Variablen für %mariadb-db-name%,%mariadb-wildfly-user%, %mariadb-wildfly-pw% und %host% eingeben und ausführen lassen.

XML

GRANT ALL PRIVILEGES ON ece2.* TO %mariadb-wildfly-user%@'localhost' IDENTIFIED BY '%mariadb-wildfly-pw%';
GRANT ALL PRIVILEGES ON ece2.* TO %mariadb-wildfly-user%@'127.0.0.1' IDENTIFIED BY '%mariadb-wildfly-pw%';
GRANT ALL PRIVILEGES ON ece2.* TO %mariadb-wildfly-user%@'::1' IDENTIFIED BY '%mariadb-wildfly-pw%';
GRANT ALL PRIVILEGES ON ece2.* TO %mariadb-wildfly-user%@'%host%' IDENTIFIED BY '%mariadb-wildfly-pw%';
FLUSH PRIVILEGES;

mySQL-Shell verlassen
JDBC-Treiber installieren
WildFly-Dienst neu starten

RE-Cockpit-Umgebung vorbereiten

Linux

Um die RE-Cockpit-Umgebung vorzubereiten und zu strukturieren, müssen Verzeichnisse in der Shell erstellt werden.

BASH

cd /opt
sudo mkdir re-environment
cd re-environment

WildFly installieren

Ab RE 3.0.0 setzt das RE‑Cockpit statt WildFly 18.0.1 nun WildFly 35 mit Java 21 (LTS) voraus.

Für Neuinstallationen von RE 3.0.x bedeutet das:

Verwendung einer WildFly‑35‑Installation (statt WildFly 18.0.1).
Konfiguration von Java 21 als Laufzeit für WildFly 35.
Anwendung der in diesem Dokument beschriebenen WildFly‑Konfigurationsschritte (Datasources, JDBC‑Treiber, Security‑Domain „ECE“, Logging) auf die WildFly‑35‑Instanz.

Für Upgrades von 2.x auf 3.0.x wird empfohlen:

eine neue WildFly‑35‑Instanz parallel aufzusetzen,
die benötigte Konfiguration (Datasource, JMS, Security‑Domain, Logging) zu übernehmen,
den passenden 3.0.x‑Installer für WildFly 35 + Java 21 zu verwenden (Details siehe ReleaseEngine 3.0.0 und ECE2 Installer).

Die nachfolgend beschriebenen Installationsschritte bleiben gültig, müssen jedoch auf die neue WildFly‑Version angewendet werden.

Diese Änderungen sind bei Neuinstallationen sowie bei Upgrades von 2.x auf 3.0.x zu berücksichtigen.

Linux

WildFly herunterladen

BASH

cd ~/Downloads
wget http://download.jboss.org/wildfly/18.0.1.Final/wildfly-18.0.1.Final.zip
sudo mv ~/Downloads/wildfly-18.0.1.Final.zip /opt/re-environment/
cd /opt/re-environment

Inhalte in das Verzeichnis /opt/re-environment extrahieren

standalone-full.xml bearbeiten, sodass es auf WildFly zugreifen kann.

Die IP-Adresse 127.0.0.1 suchen und mit der IP-Adresse des Servers ersetzen

wildfly-18.0.1.Final/standalone/configuration/standalone.xml

XML

<wsdl-host>${jboss.bind.address:127.0.0.1}</wsdl>
...
<interface name="management">
    <inet-address value="${jboss.bind.address.management:127.0.0.1}"/>
</interface>
<interface name="public">
    <inet-address value="${joss.bind.address:127.0.0.1}"/>
</interface>
<interface name="insecure">
    <inet-address value="${joss.bind.address.unsecure:127.0.0.1}"/>
</interface>

Windows

WildFly herunterladen
Inhalte entpacken
Einen neuen Ordner "WildFly" im Installationsverzeichnis anlegen
WildFly in das Installationsverzeichnis kopieren
module.xml in das Verzeichnis <Install-path>\WildFly\modules\system\layers\base\com\mysql\main
kopieren
standalone.xml in das Verzeichnis <Install-path>\WildFly\standalone\configuration
kopieren

WildFly konfigurieren

Linux

WildFly im Vordergrund starten
WildFly-Administrator anlegen
- Konsole als Administrator öffnen
- In das Verzeichnis <Install-path>/WildFly/bin wechseln
- add-user.sh ausführen
- Fragen wie folgt beantworten:

Firewall öffnen und bearbeiten, sodass auf WildFly zugegriffen werden kann

BASH

sudo systemctl enable firewalld
sudo systemctl start firewalld
sudo firewall-cmd --zone=public --add-port=8080/tcp --permanent
sudo firewall-cmd --zone=public --add-port=9990/tcp --permanent
sudo firewall-cmd --reload

WildFly als Service ausführen

BASH

cd /opt/re-environment
sudo cp ./wildfly-18.0.1.Final/docs/contrib/scripts/init.d/wildfly-init-redhat.sh  /etc/init.d/wildfly
sudo cp ./wildfly-18.0.1.Final/docs/contrib/scripts/init.d/wildfly.conf /etc/default

WildFly-User erstellen und als Besitzer angeben

BASH

sudo useradd wildfly
sudo chown wildfly:wildfly -R /opt/re-environment/wildfly-18.0.1.Final

Link in /opt-directory erstellen

BASH

sudo ln -s /opt/re-environment/wildfly-18.0.1.Final /opt/wildfly

Konfiguration bearbeiten. JBOSS_CONFIG-line finden und wie folgt ändern:

/etc/default/wildfly.conf

XML

## Location of JDK
JAVA_HOME="/usr/java/jdk-9.0.4"

## Location of WildFly
JBOSS_HOME="/opt/re-environment/wildfly-18.0.1.Final"

## The username who should own the process.
JBOSS_USER=wildfly

## The mode WildFly should start, standalone or domain
JBOSS_MODE=standalone

## Configuration for standalone mode
JBOSS_CONFIG=standalone-full.xml

## Configuration for domain mode
# JBOSS_DOMAIN_CONFIG=domain.xml
# JBOSS_HOST_CONFIG=host-master.xml

## The amount of time to wait for startup
# STARTUP_WAIT=60

## The amount of time to wait for shutdown
# SHUTDOWN_WAIT=60

## Location to keep the console log
JBOSS_CONSOLE_LOG="/var/log/wildfly/console.log"

## Additionals args to include in startup
# JBOSS_OPTS="--admin-only -b 127.0.0.1"

service-control aktivieren
BASH
```
sudo systemctl enable wildfly
```

Die standalone.xml in das Verzeichnis <Install-path>/WildFly/standalone/configuration kopieren

CODE

cd /opt/re-environment/wildfly-18.0.1.Final/standalone/configuration
sudo cp standalone.xml standalone.xml.original
sudo cp standalone-full.xml standalone.xml

WildFly stoppen und Konsole, in der es im Vordergrund gelaufen ist, schließen.
WildFly im Hintergrund starten
BASH
```
sudo systemctl start wildfly
```
WildFly stoppen

mySQL-Connector herunterladen und installieren

BASH

sudo cd /opt
sudo wget https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-8.0.17.tar.gz
sudo tar -xvzf mysql-connector-java-8.0.17.tar.gz

Das Verzeichnis <Install-path>/WildFly/modules/system/layers/base/com/mysql/main erstellen und den JDBC-Treiber in das Verzeichnis kopieren.

BASH

sudo mkdir -p /opt/wildfly/modules/system/layers/base/com/mysql/main
sudo cp mysql-connector-java-8.0.17/mysql-connector-java-8.0.17.jar /opt/wildfly/modules/system/layers/base/com/mysql/main

module.xml im Verzeichnis <Install-path>/WildFly/modules/system/layers/base/com/mysql/main mit folgendem Inhalt erstellen:

wildfly/modules/system/layers/base/com/mysql/main/module.xml

XML

<module xmlns="urn:jboss:module:1.3" name="com.mysql">
    <resources>
        <resource-root path="mysql-connector-java-8.0.17.jar"/>
    </resources>
 
    <dependencies>
        <module name="javax.api"/>
        <module name="javax.transaction.api"/>
    </dependencies>
</module>

standalone.xml bearbeiten

Die Systemeigenschaften zwischen </extensions> und <management> einfügen

standalone.xml

XML

<system-properties>
    <property name="resteasy.preferJacksonOverJsonB" value="true"/>
</system-properties>

JAAS unter <security-realms> einfügen

standalone.xml

XML

<security-realm name="ECEApplicationRealm">
    <authentication>
        <jaas name="ECE"/>
    </authentication>
</security-realm>

Das Log-Level unter <subsystem xmlns="urn:jboss-domain:logging:5.0"> einfügen

standalone.xml

XML

<logger category="com.innoface.ece">
    <level name="TRACE"/>
</logger>
 
<!-- enable SQL Logging -->
<logger category="org.hibernate.SQL">
    <level name="DEBUG"/>
</logger>
 
<!-- enable logging of BIND parameters -->
<logger category="org.hibernate.type.descriptor.sql">
    <level name="TRACE"/>
</logger>

Die JDBC-Datasource unter <datasources> einfügen

standalone.xml

XML

<datasource jta="true" jndi-name="java:jboss/datasources/ECE" pool-name="ECESqlDS" enabled="true" use-java-context="true" use-ccm="true">
    <connection-url>jdbc:mysql://localhost:3306/ece2?useSSL=false&amp;serverTimezone=Europe/Berlin</connection-url>
    <driver>mysql-connector-java-8.0.17.jar</driver>
    <pool>
        <min-pool-size>10</min-pool-size>
        <max-pool-size>100</max-pool-size>
        <prefill>true</prefill>
        <use-strict-min>false</use-strict-min>
        <flush-strategy>FailingConnectionOnly</flush-strategy>
    </pool>
    <security>
        <user-name>root</user-name>
        <password>dbmaster</password>
    </security>
</datasource>

Den JDBC-Treiber unter <drivers> einfügen

standalone.xml

XML

<driver name="mysql-connector-java-8.0.17.jar" module="com.mysql">
    <driver-class>com.mysql.cj.jdbc.Driver</driver-class>
    <xa-datasource-class>com.mysql.cj.jdbc.MysqlXADataSource</xa-datasource-class>
</driver>

JMS-Topic-Queue unter <jms-queue name="DLQ" entries="java:/jms/queue/DLQ"/> einfügen
standalone.xml
XML
```
<jms-topic name="topic/ecedaemon" entries="java:jboss/exported/jms/topic/innoface/ecedaemon"/>
```

Die Sicherheits-Domäne unter <security-domains> einfügen

standalone.xml

XML

<security-domain name="ECE">
    <authentication>
        <login-module code="com.innoface.ece.wildfly.ECELoginModule" flag="required">
            <module-option name="password-stacking" value="useFirstPass"/>
        </login-module>
    </authentication>
</security-domain>

Windows

Die standalone.xml bearbeiten

jdbc-version-template an zwei Stellen mit der jdbc-version austauschen, z.B. mysql-connector-bin.jar