Manuelle Installation

The BAM Log Adapter requires configuration of the database and manual installation of the adapter.

How to configure the database

1. In the folder <server_directory>/configurations create the file bam_log_configuration.xml.

2. Insert the following content:

   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. Save the file bam_log_configuration.xml.

How to install the adapter manually

1. Unpack the ZIP folder of the adapter.

2. Copy the folder of the adapter to the folder <server_directory>\wildfly\modules\de\softproject\x4\adapter.

3. Make sure that in the folder <server_directory>\wildfly\modules\de\softproject\x4\adapter\<name of the adapter>\main in the module.xml file in the <resources> element the paths <resource-root path="" /> correspond to the names in the *.jar files.
   Example using the BAM Log Adapter:

   1. Names of the *.jar files:

      

   2. Content of the module.xml file:

      

4. Add the adapter name to the module.xml file in the folder  <server_directory>\wildfly\modules\de\softproject\plugins\main: 

   1. Open the module.xml file in the folder <server_directory>\wildfly\modules\de\softproject\plugins\main.

   2. Cope the adapter name into the <dependencies> tag:

      <module name="de.softproject.x4.adapter.<name of the adapter>" export="true"/>

   3. Save the module.xml file.

5. Start Keycloak, the X4 Server and the X4 Designer.

The adapter can now be selected and used in the X4 Designer.