INUBIT-Datenbanken verwalten

Systemüberblick

Es gibt vier Datenbanken, die für den Cache, das Logging, das Repository und optional für den AS4-Message-Store (Nachrichtenspeicher).

administration guide 287 1

Abhängig von der Konfiguration, dem Datentyp und dem Verarbeitungsmodus werden Laufzeitdaten zusätzlich in folgenden Verzeichnissen unterhalb des Verzeichnisses <inubit-installdir>/inubit/server/ibis_root/ibis_data/binarystores gespeichert:

  • Swap-Verzeichnis für den synchronen Modus: swapsyncMainExec oder swapSyncOtherExec

  • Swap-Verzeichnis für den asynchronen Modus: swapASyncMainExec oder swapAsyncOtherExec

  • Backup-Verzeichnis für den asynchronen Modus: backupAsyncMainExec oder backupAsyncOtherExec

administration guide 288 0

Cache-Datenbank

Die Cache-Datenbank enthält hauptsächlich Moduldaten, Modulversionen, Workflows, Workflow-Versionen, Serverkonfigurationen, Benutzer, Benutzergruppen und Tag-Informationen.

Daten werden in den folgenden Fällen in die Cache-Datenbanktabellen geschrieben:

  • Beim Starten der INUBIT Workbench

  • Ein neuer Benutzer/eine neue Benutzergruppe wurde angelegt.

  • Ein neuer Workflow/ein neues Modul wurde angelegt.

  • Ein Workflow/Modul wurde in die Process Engine importiert/deployt.

  • Die Daten wurden entfernt.

In den folgenden Fällen werden Daten aus der Cache-Datenbanktabelle gelöscht:

  • Wenn ein Workflow oder Modul aus der Process Engine gelöscht wurde, werden die dazugehörigen Daten aus den Cache-Datenbanktabellen entfernt.

  • Sobald die Workflow-Ausführung abgeschlossen ist, werden die zugehörigen Daten aus den Tabellen IBIS_RT_OTHER_DATA_PERSIST mit den Laufzeitdaten und IBIS_INOUT_MSGS mit den Eingangs-/ Ausgangsnachrichten des Workflows entfernt, siehe Wichtige Cache-Datenbanktabellen und Ihre Inhalte.

  • Der mitternächtliche Aufräumprozess löscht veraltete Variablendateien des Workflow Connectors (vartmp) sowie Eingangs-/Ausgangsnachrichten.

Wurden die Daten nicht vollständig entfernt, kann es daran liegen, dass die konfigurierte Datenbank die Anfrage zum Löschen der Daten aus der Tabelle nicht ausgeführt hat oder dass der mitternächtliche Aufräumprozess mit anderen laufenden Aufgaben abgestürzt ist.

Cache-Datenbank konfigurieren

Das Konfigurieren der Cache-Datenbank erfolgt in der Datei <inubit-installdir>/inubit/server/ibis_root/conf/ibis.xml.

Zur Cache-Datenbank gehören 45 Infinispan-Tabellen, deren Namen in Großbuchstaben geschrieben sind und mit den Präfixen ISPN_ oder IBIS_ beginnen.

Mit der Eigenschaft RuntimeDataCacheXMXPercentage in der Datei ibis.xml können Sie die Menge der in der Cache-Datenbank gespeicherten Laufzeitdaten konfigurieren (standardmäßig 25 % des Xmx-Speichers).

<Property name="RuntimeDataCacheXMXPercentage" type="Integer">25</Property>

Wichtige Cache-Datenbanktabellen und Ihre Inhalte

Standardtabellen der Cache-Datenbank

Parameter Beschreibung

ISPN_MODULE_DATA

Modulbeschreibungen der Modul-Head-Versionen

ISPN_MODULE_DATA_VERSION

Modulbeschreibungen der Nicht-Head-Versionen von Modulen

ISPN_MODULE_PROPERTIES

Moduleigenschaften der Modul-Head-Versionen

ISPN_MODULE_PROPERTIES_VERSION

Moduleigenschaften der Nicht-Head-Versionen von Modulen

ISPN_SERVER_CONFIGURATION

Konfiguration des INUBIT Process Engine, wird beim Start aus der Datei <inubit-installdir>/inubit/server/ibis_root/conf/ibis_config.xml geladen

ISPN_USER

Beschreibungen der INUBIT-Benutzer

ISPN_USER_ACTIVE_TAG

Derzeit aktiver Tag-Name einer INUBIT-Gruppe oder eines INUBIT-Benutzers

ISPN_USER_GROUP

Beschreibungen der INUBIT-Benutzergruppen

ISPN_USER_META_DATA

Metadaten eines INUBIT-Benutzers

ISPN_USER_TAGS

Zu einer INUBIT-Benutzergruppe oder -Benutzer gehörende Tags

ISPN_WORKFLOW_DATA

Workflow-Beschreibungen der Workflow-Head-Versionen

ISPN_WORKFLOW_DATA_VERSION

Workflow-Beschreibungen der Nicht-Head-Versionen von Workflows

ISPN_WORKFLOW_GROUP_DATA

Beschreibungen der Workflow-Gruppen

ISPN_WORKFLOW_NAMES_FOR_USER

Zu einer INUBIT-Benutzergruppe oder -Benutzer gehörende Liste von Workflow-Namen

ISPN_WORKFLOW_VERSION_HISTORY

Historie der Workflow-Versionen

Optionale Binarystore-Tabellen, wenn RuntimeDataBackupStore als DB (Datenbank) in ibis.xml konfiguriert wurde:

Parameter Beschreibung

IBIS_INOUT_MSGS

Workflow-Eingangs-/Ausgangsnachrichten

IBIS_LIB_EXT_BINARY_STORE

Bibliotheken im Verzeichnis <inubit-installdir>/inubit/server/lib/ext

IBIS_LIB_SYS_BINARY_STORE

Bibliotheken im Verzeichnis <inubit-installdir>/inubit/server/lib/system

IBIS_RT_OTHER_DATA_PERSIST

Temporäre Laufzeitdaten (*.wfsp-Dateien)

Monitoring-Datenbank

Die Monitoring-Datenbank speichert die Daten, die mit dem INUBIT-Logging zusammenhängen, z.B. System Log, Process Log, Audit Log, Scheduler-Manager, Connection Manager und Key Manager.

Monitoring-Datenbank - Siehe INUBIT-Monitoring-Datenbank austauschen.

Die Monitoring-Datenbank wird in der Datei logsDBConfig.xml im Verzeichnis <inubit-installdir>/inubit/server/ibis_root/conf konfiguriert.

Daten werden in den folgenden Fällen in die Monitoring-Datenbanktabellen geschrieben:

  • Wenn das Trace-Log und Audit-Log in der Konfiguration aktiviert wurden.

  • Wenn ausstehende Prozesse im Queue Manager in der INUBIT Workbench vorhanden sind.

  • Wenn über den Zeitplan gestartete Jobs laufen.

  • Wenn KeyStore und TrustStore für Module, wie z.B. AS4 Connector, Mail Connector, SMIME etc., konfiguriert wurden.

In den folgenden Fällen werden Daten aus den Monitoring-Datenbanktabellen gelöscht:

Die Eigenschaft DataEntriesLimit bzw. dataEntriesLimitAuditLog definiert, für wie viele Tage die Logs in der Datenbank gültig sind. Nachdem die Grenze überschritten wurde, entfernt der mitternächtliche Aufräumprozess die Einträge aus den Logs:

  • System Log

    <dataEntriesLimit>
      <maximumLimitDays>0</maximumLimitDays>
      <minimumLimit>40000</minimumLimit>
      <maximumLimit>50000</maximumLimit>
    </dataEntriesLimit>
  • Audit Log

    <dataEntriesLimitAuditLog>
      <maximumLimitDaysAuditLog>0</maximumLimitDaysAuditLog>
      <minimumLimitAuditLog>40000</minimumLimitAuditLog>
      <maximumLimitAuditLog>50000</maximumLimitAuditLog>
    </dataEntriesLimitAuditLog>
    • MaximumLimitDays, maximumLimitDaysAuditLog

      Anzahl der Tage, nachdem die Einträge aus dem System Log und dem Audit Log entfernt wurden (Standard: 0 Tage).

    • MinimumLimit, minimumLimitAuditLog

      Mindestanzahl der im System Log und im Audit Log verbleibenden Einträge (Standard: 40'000).

    • MaximumLimit, maximumLimitAuditLog

      Sobald die maximale Anzahl an Einträgen im System Log und im Audit Log überschritten wurde, werden die Einträge gelöscht, solange die Mindestanzahl der Einträge erreicht wurde (Standard: 50'000).

Diese Einträge werden ebenfalls gelöscht, wenn die Logeinträge manuell aus dem Queue Manager gelöscht wurden.

Wichtige Monitoring-Datenbanktabellen und ihre Inhalte

Tabellenname Beschreibung

inubitLog

Die Tabelle inubitLog enthält Informationen, die im System Log unter Monitoring > System Log angezeigt werden. Die Tabelle inubitLog ist die übergeordnete Tabelle. Es gibt eine Eltern-Kind-Beziehung zwischen der Tabelle inubitLog und der Tabelle inubitWorkflow.

inubitWorkflow

Die Workflow-Ausführungsschritte werden in der Tabelle inubitWorkflow gespeichert. Die Tabelle inubitWorkflow enthält Informationen, die im Process Log unter Monitoring > Process Log angezeigt werden.

inubitQueue

Die Tabelle inubitQueue enthält Informationen über zu startende Workflows, aufgeschobene Workflows, abgestürzte Workflows und neu zu startende Workflows. Die Informationen werden im Queue Manager unter Monitoring > Queue Manager angezeigt.

inubitAudit

Die Tabelle inubitAudit enthält Informationen über das Ändern, Löschen, Erstellen und andere benutzerspezifische Aktionen. Die Informationen werden im Audit Log unter Monitoring > Audit Log angezeigt.

inubitConnection

Die Tabelle inubitConnection enthält Informationen, die im Connection Manager unter Monitoring > Connection Manager angezeigt werden. Der Connection Manager loggt alle Verbindungen, z.B. die Verbindung zwischen root und der INUBIT Workbench und das Empfangen von Lizenzinformationen seitens root.

inubitKeyManager

Die Tabelle inubitKeyManager enthält Informationen, die im Key Manager unter Monitoring > Key Manager angezeigt werden.

inubitScheduler

Die Tabelle inubitScheduler enthält Informationen, die im Scheduler Manager unter Monitoring > Scheduler Manager angezeigt werden. Wenn die Process Engine gestartet wird, liest der Scheduler Manager die Datenbanktabelle und startet zum festgelegten Zeitpunkt. Außerdem protokolliert der Scheduler Manager alle Workflows, die mit dem Scheduler ausgeführt wurden.

inubitSystemStatisticLog

Die Tabelle inubitSystemStatisticLog erfasst physische Informationen wie z.B. den verbrauchten Festplattenspeicher je Knoten, den Speicherverbrauch je Knoten, die Prozessorauslastung je Knoten, freier Festplattenspeicher und durch INUBIT belegter Festplattenspeicher. Die Tabelle inubitSystemStatisticLog kann unter Konfiguration > Allgemeine Einstellungen > Verwaltung > Reporting mit den folgenden zwei Optionen aktiviert werden:

  • Systemstatistik-Log

    Wenn diese Option aktiviert ist, werden statische statistische Informationen in das System Log geschrieben, wie z.B. CPU-Last, verbrauchter Festplattenspeicher und Prozessorauslastung je Knoten, die im Bereich Systembelastung unter Reporting angezeigt werden.

  • Log-Intervall

    Das Log-Intervall konfiguriert das Intervall, in dem die Daten gespeichert werden. Die Informationen werden im Bereich System load im Reporting angezeigt.

Repository-Datenbank

Die Repository-Datenbank enthält Daten/Informationen über das Repository und Version(en) der Repository-Dateien.

Daten werden in die Repository-Datenbank geschrieben, sobald eine neue Datei ins Repository hochgeladen, importiert oder deployt wurde, z.B. aus einer anderen INUBIT Process Engine.

Daten werden aus der Repository-Datenbank entfernt, wenn eine Datei, ein Verzeichnis oder eine Benutzergruppe aus dem Repository gelöscht wurde.

Repository-Datenbank konfigurieren

Die Repository-Datenbank wird in der Datei <inubit-installdir>/inubit/server/ibis_root/conf/repository.xml konfiguriert.

Das INUBIT-Repository basiert auf Apache Jackrabbit.

Die meisten Datenbanktabellen sind intern, bis auf die, die im folgenden Abschnitt beschrieben wurden, siehe Wichtige Repository-Datenbanktabellen und ihre Inhalte.

Wichtige Repository-Datenbanktabellen und ihre Inhalte

Parameter Beschreibung

JCR_SECURITY_BINVAL
JCR_SECURITY_BUNDLE
JCR_SECURITY_FSENTRY
JCR_SECURITY_NAMES
JCR_SECURITY_REFS

Tabellen, die die Datensicherheit betreffen

JCR_VER_BINVAL
JCR_VER_BUNDLE
JCR_VER_FSENTRY
JCR_VER_NAMES
JCR_VER_REFS

Tabellen, die die Versionierung betreffen

JCR_DS_DATA-STORE

Tabelle mit den Repository-Daten