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>/inubit/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>/inubit/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>/inubit/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>/inubit/server/process_engine/lib kopiert.

So gehen Sie vor

  1. Öffnen Sie die Datei <inubit-installdir>/inubit/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>
  2. 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>
  3. Wechseln Sie in das Verzeichnis <inubit-installdir>/inubit/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.