Datenquellen mittels JNDI konfigurieren

Mit Datenquellen werden die INUBIT-internen Datenbanken Cache-, Repository- und Logs-Datenbank bezeichnet. Die Standardkonfiguration ist in folgenden Konfigurationsdateien festgelegt, die sich im Verzeichnis <inubit-installdir>/server/ibis_root/conf/ befinden:

ibis.xml für die Cache-Datenbank.
repository.xml für die Repository-Datenbank.
logsDBConfig.xml für die Logs-Datenbank.

Sie können die Datenquellen mittels JNDI umkonfigurieren, z.B. um eine andere Datenbank zu nutzen. Dafür müssen Sie in Tomcat für die Web-Anwendung ibis die betreffenden JNDI-Resource-Elemente in der Konfigurationsdatei <inubit-installdir>/server/process_engine/webapps/ibis/META-INF/context.xml überschreiben.

Wenn Sie die Datei context.xml nach dem Start der Process Engine ändern wollen, müssen Sie die Process Engine stoppen, sowohl die Datei context.xml als auch die Datei <inubit-installdir>/server/process_engine/conf/Catalina/localhost/ibis.xml identisch ändern, und dann die Process Engine wieder starten.

Eine Konfigurationsänderung mittels JNDI hat die Vorteile:

Sie nutzt das einheitliche Format und die Verwaltungsfunktionen des Anwendungs-Containers.
Sie ist anwendungsunabhängig.

Sie können die Umkonfiguration der Datenquellen mittels JNDI nur nach der Erstinstallation von INUBIT und vor dem Erststart der Process Engine vornehmen.

Voraussetzungen

Sie haben die JDBC-Treiber für den gewünschten Datenbanktyp (z.B. Oracle) in das Verzeichnis <inubit-installdir>/server/process_engine/lib kopiert.

So gehen Sie vor

Öffnen Sie die Datei <inubit-installdir>/server/process_engine/webapps/ibis/META-INF/context.xml im Editor Ihrer Wahl.

<Context>
  <Resource
    name="jdbc/IBISDB"
    auth="Container"
    type="com.inubit.ibis.server.IBISDataSource"
    factory="org.apache.naming.factory.BeanFactory"/>
  <Resource
    name="jdbc/IBISJCRDB"
    auth="Container"
    type="com.inubit.ibis.server.IBISDataSource"
    factory="org.apache.naming.factory.BeanFactory"/>
  <Resource
    name="jdbc/IBISLOGSDB"
    auth="Container"
    type="com.inubit.ibis.server.log.LogsDBDataSource"
    factory="org.apache.naming.factory.BeanFactory"/>
</Context>

Bearbeiten Sie das/die Resource-Element/e, für das/die Sie die Datenquelle ändern möchten.

Das Beispiel zeigt den geänderten Eintrag für die Logs-Datenbank (Ressource jdbc/IBISLOGSDB):

<Context>
...
  <Resource name="jdbc/IBISLOGSDB" auth="Container"
    type="javax.sql.DataSource" username="dbusername" password="dbpassword"
    driverClassName="org.hsql.jdbcDriver" url="jdbc:HypersonicSQL:database"
    maxActive="8" maxIdle="4"/>
</Context>

Wechseln Sie in das Verzeichnis <inubit-installDir>/server/ibis_root/conf/ und kopieren Sie die für Ihre Ziel-Datenbank (datenbank) geeignete Konfigurationsdatei wie folgt:
- Falls Sie die Cache-Datenbank ändern möchten, ist keine Datei zu kopieren, da in ibis.xml keine Datenbank-spezifischen Angaben enthalten sind.
- Falls Sie die Repository-Datenbank ändern möchten, kopieren Sie repository.xml.<datenbank>.<CLUSTER|SINGLE> nach repository.xml.
- Falls Sie die Logs-Datenbank ändern möchten, kopieren Sie logsDBConfig.xml.<datenbank> nach logsDBConfig.xml.
  
  Sichern Sie vor dem Kopieren die Konfigurationsdateien repository.xml und logsDBConfig.xml.