Inhalt

Stand: 10.12.2020

Wildfly 18 Setup - Standard / Standalone

Vorbereitung Basiskonfiguration Wildfly 18

Voraussetzungen

WF18_INSTALLATION_DIR => das Installationsverzeichnis, in dem der WF18 installiert wurde
WF_USER und WF_GROUP existieren (jboss, jboss) oder (wildfly, jboss)
Wildfly Version 18.0.1.Final ist in WF18_INSTALLATION_DIR installiert
der Wildfly 18 ist als service eingerichtet (e.g. service wildfly18 status / start / stop funktioniert)
- /etc/default/wildfly[18]
  - LANG="de_DE.UTF-8"
im Verzeichnis X_DEPLOY liegen
- ica-1.7.x.ear
- wildfly_18_mysql_module.tar

Änderungen der Konfiguration

Issue	Change
1	MySql-JDBC als Module der WF 18 Installation hinzufügen
2	Anpassung Servlet Container
3	ICA Parameter anpassen
4	Default Memory settings anpassen
5	Management user anlegen
6	Eintragen / Anlegen der Datasource / XA-Datasource

Mysql als Modul

ins Wildfly 18 Installationsverzeichnis wechseln
- cd WF18_INSTALLATION_DIR
- Mysql- Modul auspacken
- tar -xf X_DEPLOY/wildfly_18_mysql_module.tar
- Rechte prüfen (user = jboss / wildfly, Gruppe: jboss)

Anpassung Servlet Container

cd WF18_INSTALLATION_DIR
- standalone/configuration/standalone.xml
  - suche nach "<servlet-container"
    - änder zu:

		<servlet-container name="default" allow-non-standard-wrappers="true">
               <jsp-config/>
               <websockets/>
        </servlet-container>

Anpassungen Logging

Zweck: Logging Konfiguration über standalone.xml / WF Admin Interface. Ignoriert die log4j Properties Einstellung aus dem Deployment.

File: standalone.xml

Einfügen von: <use-deployment-logging-confg value="false">, bzw. ändern von true auf false!

Logging configuration via Wildfly

 <subsystem xmlns="urn:jboss:domain:logging:8.0">
            <use-deployment-logging-config value="false"/>
            <console-handler name="CONSOLE">

ICA Parameter anpassen

Die JVM-Parameter (JAVA_OPTS) aus der laufenden ICA-Installation (WF 8.x Installation) in der Datei: WF18_INSTALLATION_DIR/bin/standalone.sh eintragen:

ICA-Parameter
- de.iconcept.servermode
- de.iconcept.nami.crypto.EncryptionEnabled
- de.iconcept.nami.entity.org.Gruppierung.GrpDigitCount
- license.modules
File Encoding Jasper Reports anpassen:
- file.encoding=UTF-8

Sonstige Settings / Default Memory settings anpassen

Netwerk (empfohlen)
- java.net.preferIPv4Stack=true
Memory (je nachdem, wie leistungsstrark der Server ist und ob es sich um ein Produktiv- oder Testsystem handelt):
- -Xmx4096m (min, für PRD Systeme, besser 8GB)
- -Xms512m

Management User anlegen

cd WF18_INSTALLATIN_DIR/bin
- ./add-user.sh
  - bitte auf jeden fall einen zusätzlichen Management-User (username: sadmin) anlegen
    - nach Anlage stehen die User unter anderem in der Datei WF18_INSTALLATION_DIR/standalone/configuration/mgmt-users.properties
      - das eingetragen PW für den user sadmin wird vom Smadoa Support geändert werden

Datasource eintragen

Unterschied Datasource / XA-Datasource: Eine XA-Datasource wird nur benötigt, falls der Application Server ggf. in Zukunft mit mehreren EJB-Knoten betrieben werden soll. Im Standard (standalone Konfiguration) reicht die Anlage einer normalen Datasource.

Anlage: Am einfachsten über das Web-Interface.

im Standard existiert die Datasource ExampleDS (H2 DataSource). Diese muss enabled bleiben, ansonsten starten die ICA-Versionen bis 1.7.x (einschließlich) nicht.
es muss eine Datasource auf die angelegte Datenbank eingerichtet werden. Der JNDI-Name der Datasource muss java:/IcaDb sein.
Connection URL: es sollte autoReconnect=true gesetzt werden

Example Datasource	Ica Datasource

Nachdem die Datasource eingetragen wurde muss der Transaction Isolation Level auf "TRANSACTION_READ_UNCOMMITTED" eingestellt werden.

Anpassung Parameter - running Wildfly, ICA deployed

Vorgehen:

der Zugriff auf die Datenbank (DataSource IcaDB) sollte möglich sein (Test Connection)
die ICA-Anwendung sollte "deployed" aber nicht aktiviert sein
- Deployment über Kommandozeile:
  - cd WF18_INSTALLATION_DIR/bin
  - ./jboss-cli.sh
  - connect (anmelden)
  - deploy X_DEPLOY/ica-1.7.0-rc02.ear --runtime-name=NaMi_ear.ear --disabled
- Der runtime-name muss NaMi_ear.ear sein. Der Deployment-Name sollte nicht geändert werden. Damit ist sichergestellt, dass unterschiedliche ICA-Releases unterschieden werden können

Nachdem ICA erstmalig deployed, aber noch NICHT gestartet wurde sind einmalig folgende Anpassungen vorzunehmen:

Setting	Check	Recommended
Active Sessions	Check and modify number of active sessions /deployment=NaMi_ear.ear/subdeployment=NaMi_web.war/subsystem=undertow:read-resource(include-runtime=true)	-1 (unlimited) specific value (e.g. 200)
Enable EJB Pooling for stateless beans	check Pool usage, EJB Layer: Read: /subsystem=ejb3:read-attribute(name=default-slsb-instance-pool) Write (if not existing) /subsystem=ejb3/:write-attribute(name=default-slsb-instance-pool,value=slsb-strict-max-pool) Configure Cache for stateless beans: Read Write	Unbedingt
EJB Thread Pools size	Check value READ: /subsystem=ejb3/thread-pool=default:read-attribute(name=max-threads) Write: (setting to 100 threads) /subsystem=ejb3/thread-pool=default:write-attribute(name=max-threads, value=100)	Abhängig von der Systemleistung

Anpassung Logging Subsystem

Über das WF 18 Web-Interface:

Das Logging-Subsystem sollte wie folgt angepasst werden:

Default Log-Level: Error
Log Level für Package "de.iconcept" anlegen, mit folgenden Parametern:
- Log-Level: ERROR
- use Parent Handler

Page tree

ICA 1.7.x