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
```
Hinweis

Hier müssen der Username und das Passwort der Datenbank benutzt werden.
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 restart

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

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