X4 Produktdokumentation

Manuelle Installation

Für den BAM Log Adapter ist eine Konfiguration der Datenbank sowie die manuelle Installation des Adapters erforderlich.

So konfigurieren Sie die Datenbank

  1. Erstellen Sie im Ordner <Serververzeichnis>/configurations die Datei bam_log_configuration.xml.

  2. Fügen Sie den folgenden Inhalt ein:

    XML
    <?xml version="1.0"?>
    <Configuration>
    	<ConnectionString>JDBC-CONNECTION</ConnectionString> 
    	<UserName>USERNAME</UserName> 
    	<Password>PASSWORD</Password>     
        <KeepLogs>
            <Duration>1</Duration>
            <TimeUnit>DAYS</TimeUnit>
        </KeepLogs>
        <RunCleanUp>
            <Duration>1</Duration>
            <TimeUnit>HOURS</TimeUnit>
        </RunCleanUp>
    </Configuration>
    


  3. Speichern Sie die Datei bam_log_configuration.xml.


So installieren Sie den Adapter manuell

  1. Entpacken Sie den ZIP-Ordner des Adapters. 

  2. Kopieren Sie den Ordner des Adapters in den Ordner <Serververzeichnis>\wildfly\modules\de\softproject\x4\adapter.

  3. Stellen Sie sicher, dass im Ordner <Serververzeichnis>\wildfly\modules\de\softproject\x4\adapter\<Names des Adapters>\main in der Datei module.xml im Element <resources> die Pfade <resource-root path="" /> den Namen der *.jar-Dateien entsprechen.
    Beispiel anhand des BAM Log Adapters:

    1. Namen der *.jar-Dateien:

      FilesName.png?version=2&modificationDate=1701891882053&cacheVersion=1&api=v2&height=150
    2. Inhalt der Datei module.xml:

      module.xml-main.png?version=2&modificationDate=1701891882041&cacheVersion=1&api=v2&height=250
  4. Fügen Sie den Namen des Adapters im Ordner <Serververzeichnis>\wildfly\modules\de\softproject\plugins\main in der Datei module.xml hinzu: 

    1. Öffnen Sie die Datei module.xml im Ordner <Serververzeichnis>\wildfly\modules\de\softproject\plugins\main.

    2. Kopieren Sie den Adapternamen in den Tag <dependencies>:

      <module name="de.softproject.x4.adapter.<Name des Adapters>" export="true"/>

    3. Speichern Sie die Datei module.xml.

  5. Starten Sie Keycloak, den X4 Server und den X4 Designer.

Nun kann der Adapter im X4 Designer ausgewählt und genutzt werden.