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"
- /etc/default/wildfly[18]
- 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:
- suche nach "<servlet-container"
- standalone/configuration/standalone.xml
<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
- 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
- file.encoding=UTF-8
Sonstige Settings / Default Memory settings anpassen
- Netwerk (empfohlen)
- java.net.preferIPv4Stack=true
- 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
- nach Anlage stehen die User unter anderem in der Datei WF18_INSTALLATION_DIR/standalone/configuration/mgmt-users.properties
- bitte auf jeden fall einen zusätzlichen Management-User (username: sadmin) anlegen
- ./add-user.sh
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
- Deployment über Kommandozeile:
Nachdem ICA erstmalig deployed, aber noch NICHT gestartet wurde sind einmalig folgende Anpassungen vorzunehmen:
Setting | Check | Recommended |
---|---|---|
Active Sessions |
|
|
Enable EJB Pooling for stateless beans |
| Unbedingt |
EJB Thread Pools size |
| 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 foglenden Parametern:
- Log-Level: ERROR
- use Parent Handler
Logging ICA
siehe https://www.smadoa.de/confluence/x/NwFn