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 suche und mit der IP-Adresse des Severs 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

Hinweis

Ein JDBC Treiber muss im Verzeichnis <WildFly_home>\modules\system\layers\base\com\mysql\main existieren.
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:

Frage	Antwort
What type of user do you wish to add?	a
Username:	z.B. wfadmin
Password:	z.B. wild_fly1
What groups do you want this user to belong to:	blank
About to add user 'wfadmin' for realm 'ManagementRealm'	yes
Is this new user going to be used for one AS process to connect to another AS process?	yes

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

(Ohne ist der Server nicht über den Hostname oder die IP-Adresse erreichbar)
Da die aktuelle Konfiguration in wildfly.conf nicht ideal funktioniert muss man hier mit einem Workaround arbeiten!

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, indem es im Vordergrund gelaufen ist, schließen.
Wildfly im Hintergrund starten
BASH
```
sudo systemctl start wildfly
```
Info

Nun kann man unter der URL http://servername:8080 prüfen ob Wildfly korrekt gestartet wurde.
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 folgenden 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