BAM Logging: Migration

No migration is required for the BAM Logging Adapter from X4 BPMS versions 6.x.

The migration of the BAM Log Adapter (versions 1.0.0 and 1.1.0) to version 2.0.0 requires a change to the database structure.

Exchange of the Adapter

1. Delete the module <server-directory>\wildfly\modules\de\softproject\x4\adapter\BamLogAdapter and the corresponding entry from the file <server_directory>\wildfly\modules\de\softproject\x4\extensions\main\module.xml.
2. Save the new module bamlog in the folder <server_directory>\wildfly\modules\de\softproject\x4\adapter.
3. Add the adapter in the file <server_directory>\wildfly\modules\de\softproject\extensions\main\module.xml:
   1. Open the file module.xml in the folder <server_directory>\wildfly\modules\de\softproject\extensions\main.
   2. Copy the adapter name into the <dependencies> tag:

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

4. Restart the X4 Server.
   The BAM Log Adapter 2.0.0 is now available in the Designer.

Exchange of the Adapter in the Projects View

Note:

If the same name has been selected for the adapter definition file, nothing needs to be adjusted in the processes.

• After the restart of the X4 Server, delete the previous adapter definition of the BAM Logging adapter (.fa file).
• Create the adapter again.

Exchange of Implicit BAM Logging in Processes

Note:

If implicit BAM logging (on transitions) is still used in processes, the adapter must be exchanged in the process.

1. Open the relevant process with an XML editor.

2. Replace in the following section in all XML elements with the type Action[@type='BAM'] the entry de.softproject.integration.nativeadapter.NativeAdapter with de.softproject.integration.adapter.bam.BAMAdapter:

   XML

   <Parameter id="2"
              type="UserDefined">
   	<name>Adapter</name>
   	<value>de.softproject.integration.nativeadapter.NativeAdapter</value>
   </Parameter> 

   XML element after exchanging the adapter name:

   XML

   <Parameter id="2"
              type="UserDefined">
   	<name>Adapter</name>
   	<value>de.softproject.integration.adapter.bam.BAMAdapter</value>
   </Parameter> 

Exchange of the Database Tables

Optimizations have been made in the tables x4data, x4message, x4status. The easiest way to adapt to this is to rename or delete the previous tables if the data is not required anymore. The tables are automatically created again when the X4 Server is started.