Oracle-Datenbank einrichten
Sollten Sie eine Oracle-Datenbank verwenden, müssen folgende zusätzlichen Einstellungen vorgenommen werden:
Migrations/Installations-Werkzeug ausführen
Beachten Sie:
Vor dem Ausführen des Migrations-/Installations-Tools, muss zunächst eine leere Datenbank mit dem Namen X4 angelegt werden.
Um das Migrations-Werkzeug (siehe Installationshandbuch -> Update Tool) mit Oracle verwenden zu können, muss beim Aufruf des Tools der Oracle-Treiber dem Classpath hinzugefügt werden.
Treiber für die entsprechende Oracle Datenbank finden Sie unter https://www.oracle.com/database/technologies/appdev/jdbc.html.
Treiber als Wildfly-Modul bereitstellen
Entsprechenden Treiber unter https://www.oracle.com/database/technologies/appdev/jdbc.html herunterladen.
Wildfly-Modul für den JDBC-Treiber erstellen. Dazu im Verzeichnis
X4\Server\wildfly\modules\
zunächst die Verzeichnis-Strukturoracle\jdbc\main
anlegen.JDBC-Treiber (z. B.:
ojdbc.jar
) im oben angelegten Verzeichnis entpacken.Die Datei
module.xml
mit folgendem Inhalt anlegen:module.xml
XML<module xmlns="urn:jboss:module:1.5" name="oracle.jdbc"><!-- Der Namespace urn:jboss:module:1.5 kann sich zwischen den Wildfly Versionen unterscheiden. --> <resources> <resource-root path="ojdbc.jar"/><!-- Hier den Dateinamen des JDBC Treibers angeben, der verwendet werden soll und sich im Verzeichnis befindet. --> </resources> <dependencies> <module name="javax.api"/> <module name="javax.transaction.api"/> </dependencies> </module>
Das Modul
oracle.jdbc
steht nun zur Verfügung.
Treiber in standalone.xml eintragen
Um den Treiber in den Datasources verwenden zu können, den Treiber in der standalone.xml
unter X4\Server\wildfly\standalone\configuration\
eintragen:
...
<subsystem xmlns="urn:jboss:domain:datasources:5.0">
<datasources>
...
<drivers>
...
<driver name="oracle" module="oracle.jdbc"><!-- Hier den Modul-Namen eintragen -->
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
</driver>
</drivers>
</datasources>
</subsystem>
...
Datasources konfigurieren
Oracle-Datasources in der standalone.xml
unter X4\Server\wildfly\standalone\configuration\
konfigurieren:
...
<subsystem xmlns="urn:jboss:domain:datasources:5.0">
<datasources>
...
<datasource jta="false" jndi-name="java:/X4BAM_DS" pool-name="X4BAM_DS" enabled="true" use-java-context="true">
<connection-url>jdbc:oracle:thin:@localhost:1521/pluggable-database</connection-url><!-- Hier den entsprechenden Host, Port, SID oder Service-Namen entragen -->
<driver>oracle</driver><!-- Hier den Treiber-Namen eintragen -->
<security user-name="X4SERVER" password="X4"/>
<statement>
<prepared-statement-cache-size>32</prepared-statement-cache-size>
</statement>
<!-- In <validation> und <timeout> Einstellungen zur automatischen Verbindungsherstellung der Verbindung vornehmen -->
<validation>
<check-valid-connection-sql>select 1 from dual</check-valid-connection-sql>
<validate-on-match>false</validate-on-match>
<background-validation>true</background-validation>
<background-validation-millis>1000</background-validation-millis>
</validation>
<timeout>
<allocation-retry>60</allocation-retry>
<allocation-retry-wait-millis>1000</allocation-retry-wait-millis>
</timeout>
</datasource>
<datasource jta="true" jndi-name="java:/PermissionDS" pool-name="PermissionDS" enabled="true" use-java-context="true">
<connection-url>jdbc:oracle:thin:@localhost:1521/pluggable-database</connection-url><!-- Hier den entsprechenden Host, Port, SID oder Service-Namen entragen -->
<driver>oracle</driver><!-- Hier den Treiber-Namen eintragen -->
<security user-name="X4SERVER" password="X4"/>
<statement>
<prepared-statement-cache-size>32</prepared-statement-cache-size>
</statement>
<!-- In <validation> und <timeout> Einstellungen zur automatischen Verbindungsherstellung der Verbindung vornehmen -->
<validation>
<check-valid-connection-sql>select 1 from dual</check-valid-connection-sql>
<validate-on-match>false</validate-on-match>
<background-validation>true</background-validation>
<background-validation-millis>1000</background-validation-millis>
</validation>
<timeout>
<allocation-retry>60</allocation-retry>
<allocation-retry-wait-millis>1000</allocation-retry-wait-millis>
</timeout>
</datasource>
<drivers>
...
<driver name="oracle" module="oracle.jdbc"><!-- Hier den Modul-Namen eintragen -->
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
</driver>
</drivers>
</datasources>
</subsystem>
...