Skip to main content
Skip table of contents

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

  1. Entsprechenden Treiber unter https://www.oracle.com/database/technologies/appdev/jdbc.html herunterladen. 

  2. Wildfly-Modul für den JDBC-Treiber erstellen. Dazu im Verzeichnis X4\Server\wildfly\modules\ zunächst die Verzeichnis-Struktur oracle\jdbc\main anlegen.

  3. JDBC-Treiber (z. B.: ojdbc.jar ) im oben angelegten Verzeichnis entpacken. 

  4. 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:

XML
...
<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:

XML
...
<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>
...

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.