Manual Installation

How to install adapters manually

1. Unzip the adapter's ZIP folder.

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

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

   1. Names of *.jar files:

      

   2. Contents of the module.xml file:

      

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

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

   2. Copy the plugin name into the <dependencies> tag:

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

   3. Save the module.xml file.

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

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