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)
- 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"
<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!
<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
- File Encoding Jasper Reports anpassen:
Sonstige Settings / Default Memory settings anpassen
- Netwerk (empfohlen)
- 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
| 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:
| 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