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 <SUITE-INSTALL-DIR>/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 <SUITE-INSTALL-DIR>/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 <SUITE-INSTALL-DIR>/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 ersten Start der Process Engine vornehmen.

Voraussetzungen

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

So gehen Sie vor

  1. Öffnen Sie die Datei <SUITE-INSTALL-DIR>/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 <SUITE-INSTALL-DIR>/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.