

Migrating from WSO2 ESB 5.0 to WSO2 EI 7.1¶

This guide provides the recommended strategy for migrating from WSO2 ESB 5.0 to the Micro Integrator of WSO2 EI 7.1.

Why migrate to EI 7.1?¶

Listed below are some of the advantages of moving to EI 7.1 from the ESB.

The Micro Integrator of EI 7.1 is now the most improved version of the battle-tested WSO2 ESB runtime.

Tip

WSO2 ESB 5.0, the ESB profile of WSO2 EI 6.x family, as well as the Micro Integrator of WSO2 EI 7.x family contains versions of the same WSO2 ESB runtine.
All the ESB runtimes of WSO2 can use the same developer tool (WSO2 Integration Studio) for developing integrations.
All the integration capabilities that you used in the ESB can be used in the Micro Integrator with minimal changes.
The Micro Integrator contains improvements to ease your product experience.

Note

The most significant change in EI 7.1 is the Toml-based configuration strategy, which replaces the XML configurations in previous versions of the ESB runtime. Some of the features are removed from WSO2 Micro Integrator as they are not frequently used.

Migration from the WSO2 ESB is recommended for the following requirements:

You need to switch to a microservices architecture from the conventional centralized architecture.
You need a more lightweight, user-friendly version of the battle-tested WSO2 ESB.
You need a more lightweight, container-friendly runtime in a centralized architecture.
You need native support for Kubernetes.

Before you begin¶

The Micro Integrator of EI 7.1 contains changes that will impact your migration process. Be sure to read the following resources before you start.

Note that EI 7.x is a WUM-only release, which means that manual patches are not allowed. You can use WSO2 Update Manager(WUM) to get the latest fixes or updates for this release.

Migrating to the Micro Integrator¶

Follow the instructions below to start the migration!

Set up the migration¶

Make a backup of the ESB 5.0 distribution (<ESB_5.0.0_HOME> folder) to back up the product configurations.
Make a backup of the database used by the current ESB 5.0 deployment. This backup is necessary in case the migration causes any issues in the existing database.
Download and install EI 7.1 in your environment:

Tip

The home directory of your Micro Integrator will be referred to as <MI_HOME> from hereon.
- Install the product using the Installer.
- Install the product using the binary distribution.
Use WSO2 Update Manager to get the latest available updates for your EI 7.1 distribution.

Info

Note that you need a valid WSO2 subscription to use updates in a production environment.

Migrating the user store¶

If you are already using a JDBC or LDAP as the primary user store of your ESB 5.0, you can simply connect the same to the Micro Integrator by updating the configuration details in the deployment.toml file. Following is a set of high-level configurations.

RDBMS User Store

[user_store]
type = "database"
read_only = "false"

[[datasource]]
id = "WSO2_USER_DB"
url= "jdbc:mysql://localhost:3306/userdb"
username="root"
password="root"
driver="com.mysql.jdbc.Driver"

[realm_manager]
data_source = "WSO2_USER_DB" 

[internal_apis.file_user_store]
enable = false

Read-Only LDAP User Store

[user_store]
connection_url = "ldap://localhost:10389"  
connection_name = "uid=admin,ou=system"
connection_password = "admin"  
user_search_base = "ou=Users,dc=wso2,dc=org"
type = "read_only_ldap"

[internal_apis.file_user_store]
enable = false

Read-Write LDAP User Store

[user_store]
connection_url = "ldap://localhost:10389"  
connection_name = "uid=admin,ou=system"
connection_password = "admin"  
user_search_base = "ou=Users,dc=wso2,dc=org"
type = "read_write_ldap"

[internal_apis.file_user_store]
enable = false

See the instructions on configuring a user store for more information.

Secondary users stores

Note that secondary user stores are currently not supported in the Micro Integrator of EI 7.1.0.

Migrating the registry¶

The Micro Integrator uses a file-based registry instead of a database (which is used in ESB 5.0). Note the following when migrating the registry:

If the registry resources in ESB 5.0 are added via carbon applications developed using WSO2 Integration Studio, you can directly migrate the artifacts to the Micro Integrator of EI 7.1. Copy the carbon applications from the <ESB_5.0.0_HOME>/repository/deployment/server/carbonapps folder to the <MI_HOME>/repository/deployment/server/carbonapps folder.
If the registry resources are added through the management console in ESB 5.0, you need to convert them to a Registry Resources module in WSO2 Integration Studio and deploy them via a Carbon Application. Use one of the following approaches:
- Checkout the Registry Resources from the ESB 5.0 server directly into the Registry Resources module in WSO2 Integration Studio.
- Download the Registry Resources from ESB 5.0 and import them into the Registry Resources module in WSO2 Integration Studio.
Note

Once you have imported the Registry Resources into WSO2 Integration Studio, open the resource editor and make sure that the media type of the resource is set properly.
If you have encrypted data in the ESB 5.0 registry, follow the instructions in migrating passwords.

Migrating artifacts¶

The recommended way to create integration artifacts (in ESB 5.0 or EI 7.x ) is to use WSO2 Integration Studio:

If the artifacts are created in the recommended way, copy the CAR files inside <ESB_5.0.0_HOME>/repository/deployment/server/carbonapps to the <MI_HOME>/repository/deployment/server/carbonapps folder.
If the artifacts are created using the management console of ESB 5.0, you need to recreate them using WSO2 Integration Studio and package them as a composite application. See the instructions on packaging artifacts.

Tip

For testing purposes, you can copy the artifacts to the same folder structure inside the <MI_HOME>/repository/deployment/server/synapse-configs/default directory.

Migrating deployed Connectors¶

If the connector is added to ESB 5.0 via a composite application with the Connector Exporter Project, the same can be used in EI 7.1 seamlessly. Simply copy the CAR file in ESB 5.0 to the <MI_HOME>/repository/deployment/server/carbonapps folder.
If the connector is added to ESB 5.0 via the management console, pack them using connector exporter project and deploy via composite application in EI 7.1. For more information, read about the Connector Exporter Project.

Migrating custom components¶

Copy custom OSGI components in the <ESB_5.0.0_HOME>/repository/components/dropins folder to the <MI_HOME>/dropins folder. If you have custom JARs in the <ESB_5.0.0_HOME>/repository/components/lib directory, copy those components to the <MI_HOME>/lib directory.

Note

To provide seamless integration with RabbitMQ, the Rabbitmq client lib is included in the Micro Integrator by default. Hence, you don't need to manually add any RabbitMQ components.

Migrating keystores¶

Copy the JKS files in the <ESB_5.0.0_HOME>/repository/resources/security directory to the <MI_HOME>/repository/resources/security directory.

Migrating configurations¶

Configuration management was handled in WSO2 ESB 5.0 versions via multiple files such as carbon.xml, synapse.properties, axis2.xml, etc.

Micro Integrator of EI 7.1 provides a new configuration model where all of the product configurations are primarily managed by a single configuration file named deployment.toml (stored in the <MI_HOME>/conf directory).

In EI 7.1, the logging configurations are managed with log4j2, whereas the ESB 5.0 used log4j.

The following sections of this document will guide you on how to migrate the Product Configurations including log4j.

Migrating to TOML configurations

Given below are the most critical XML configuraton files in ESB 5.0. Expand each section to find the TOML configurations corresponding to the XML configurations in the file.

Tip

If you have a WSO2 subscription, it is highly recommended to reach WSO2 Support before attempting to proceed with the configuration migration.

carbon.xml

Hostname

XML configuration

<HostName>www.wso2.org</HostName>

TOML configuration

[server]
hostname = "www.wso2.org"

Find more parameters.

Port offset
XML configuration
```
<Ports>
    <Offset>1</Offset>
</Ports>
```
TOML configuration
```
[server] 
offset  = 0
```
Find more parameters.

Primary keystore

XML configuration

<Security>
    <KeyStore>            
        <Location>${carbon.home}/repository/resources/security/wso2carbon.jks</Location>
        <Type>JKS</Type>
        <Password>wso2carbon</Password>
        <KeyAlias>wso2carbon</KeyAlias>
        <KeyPassword>wso2carbon</KeyPassword>
    </KeyStore>
</Security>

TOML configuration

[keystore.primary] 
file_name = "wso2carbon.jks"
type = "JKS"
password = "wso2carbon"
alias = "wso2carbon"
key_password = "wso2carbon"

Find more parameters.

Internal keystore

XML configuration

<InternalKeyStore>
     <Location>${carbon.home}/repository/resources/security/wso2carbon.jks</Location>
        <Type>JKS</Type>
        <Password>wso2carbon</Password>
        <KeyAlias>wso2carbon</KeyAlias>
       <KeyPassword>wso2carbon</KeyPassword>
</InternalKeyStore>

TOML configuration

[keystore.internal] 
file_name = "wso2carbon.jks"
type = "JKS"
password = "wso2carbon"
alias = "wso2carbon"
key_password = "wso2carbon"

Find more parameters.

Truststore

XML configuration

<TrustStore>
    <Location>${carbon.home}/repository/resources/security/client-truststore.jks</Location>
    <Type>JKS</Type>
    <Password>wso2carbon</Password>
</TrustStore>

TOML configuration

[truststore] 
file_name = "client-truststore.jks"  
type = "JKS"                        
password = "wso2carbon"            
alias = "symmetric.key.value"      
algorithm = "AES"

Find more parameters.

user-mgt.xml

Admin user

XML configuration

<Realm>
    <Configuration>
        <AdminRole>admin</AdminRole>
        <AdminUser>                
            <UserName>admin</UserName>                
            <Password>admin</Password>
        </AdminUser>
    </Configuration>
</Realm>

TOML configuration

[super_admin]
username = "admin"              # inferred 
password = "admin"              # inferred 
admin_role = "admin"            # inferred

User datasource

XML configuration

<Realm>
    <Configuration>
         <Property name="isCascadeDeleteEnabled">true</Property>
         <Property name="dataSource">jdbc/WSO2CarbonDB</Property>
    </Configuration>
</Realm>

TOML configuration

[realm_manager] 
data_source = "WSO2CarbonDB"       
properties.isCascadeDeleteEnabled = true

LDAP userstore

XML configuration

<UserStoreManager class="org.wso2.carbon.user.core.ldap.ReadOnlyLDAPUserStoreManager">
    <Property name="TenantManager">org.wso2.carbon.user.core.tenant.CommonHybridLDAPTenantManager</Property>
    <Property name="ConnectionURL">ldap://localhost:10389</Property>
    <Property name="ConnectionName">uid=admin,ou=system</Property>
</UserStoreManager>

TOML configuration

[internal_apis.file_user_store]
enable = false

[user_store]
type = "read_only_ldap" # inferred default read_only_ldap # OR  read_write_ldap
class = "org.wso2.micro.integrator.security.user.core.ldap.ReadOnlyLDAPUserStoreManager" # inferred
connection_url = "ldap://localhost:10389"   #inferred
connection_name = "uid=admin,ou=system"   #inferred

Find more parameters.

JDBC userstore

XML configuration

 <UserStoreManager class="org.wso2.carbon.user.core.jdbc.JDBCUserStoreManager">
    <Property name="TenantManager">org.wso2.carbon.user.core.tenant.JDBCTenantManager</Property>
 </UserStoreManager>

TOML configuration

[internal_apis.file_user_store]
enable = false

[user_store]
class = "org.wso2.micro.integrator.security.user.core.jdbc.JDBCUserStoreManager"
type = "database"

master-datasource.xml

Carbon database (WSO2_CARBON_DB).

XML configuration

<datasource>
    <name>WSO2_CARBON_DB</name>
    <description>The datasource used for registry and user manager</description>
    <jndiConfig>
        <name>jdbc/WSO2CarbonDB</name>
    </jndiConfig>
    <definition type="RDBMS">
        <configuration>
            <url>jdbc:h2:./repository/database/WSO2CARBON_DB;DB_CLOSE_ON_EXIT=FALSE;LOCK_TIMEOUT=60000</url>
            <username>wso2carbon</username>
            <password>wso2carbon</password>
            <driverClassName>org.h2.Driver</driverClassName>
            <maxActive>50</maxActive>
            <maxWait>60000</maxWait>
            <testOnBorrow>true</testOnBorrow>
        </configuration>
    </definition>
</datasource>

TOML configuration

[[datasource]]
id = "WSO2_CARBON_DB"
url= "jdbc:h2:./repository/database/WSO2CARBON_DB;DB_CLOSE_ON_EXIT=FALSE;LOCK_TIMEOUT=60000"
username="username"
password="password"
driver="org.h2.Driver"
pool_options.maxActive=50
pool_options.maxWait = 60000 # wait in milliseconds
pool_options.testOnBorrow = true

Find more parameters.

axis2.xml

Hot deployment

XML configuration

<parameter name="hotdeployment" locked="false">true</parameter>

TOML configuration

[server]
hot_deployment = true

Enable MTOM

XML configuration

<parameter name="enableMTOM" locked="false">false</parameter>

TOML configuration

[server]
enable_mtom = false

Find more parameters.

Enable SWA

XML configuration

<parameter name="enableSwA" locked="false">false</parameter>

TOML configuration

[server]
enable_swa = false

Find more parameters.

Message formatters

XML configuration

<messageFormatters>
        <messageFormatter contentType="application/x-www-form-urlencoded"
                          class="org.apache.synapse.commons.formatters.XFormURLEncodedFormatter"/>
        <messageFormatter contentType="multipart/form-data"
                          class="org.apache.axis2.transport.http.MultipartFormDataFormatter"/>
        <messageFormatter contentType="application/xml"
                          class="org.apache.axis2.transport.http.ApplicationXMLFormatter"/>
        <messageFormatter contentType="text/xml"
                         class="org.apache.axis2.transport.http.SOAPMessageFormatter"/>
        <messageFormatter contentType="application/soap+xml"
                         class="org.apache.axis2.transport.http.SOAPMessageFormatter"/>
        <messageFormatter contentType="text/plain"
                         class="org.apache.axis2.format.PlainTextFormatter"/>
        <messageFormatter contentType="application/octet-stream"
                          class="org.wso2.carbon.relay.ExpandingMessageFormatter"/>
        <messageFormatter contentType="application/json"
                          class="org.wso2.carbon.integrator.core.json.JsonStreamFormatter"/>
</messageFormatters>

TOML configuration

[message_formatters]
form_urlencoded =  "org.apache.synapse.commons.formatters.XFormURLEncodedFormatter"
multipart_form_data =  "org.apache.axis2.transport.http.MultipartFormDataFormatter"
application_xml = "org.apache.axis2.transport.http.ApplicationXMLFormatter"
text_xml = "org.apache.axis2.transport.http.SOAPMessageFormatter"
soap_xml = "org.apache.axis2.transport.http.SOAPMessageFormatter"
text_plain = "org.apache.axis2.format.PlainTextFormatter"
application_json =  "org.wso2.micro.integrator.core.json.JsonStreamFormatter"
octet_stream = "org.wso2.carbon.relay.ExpandingMessageFormatter"

Find more parameters.

Message builders

XML configuration

<messageBuilders>
        <messageBuilder contentType="application/xml"
                        class="org.apache.axis2.builder.ApplicationXMLBuilder"/>
        <messageBuilder contentType="application/x-www-form-urlencoded"
                        class="org.apache.synapse.commons.builders.XFormURLEncodedBuilder"/>
        <messageBuilder contentType="multipart/form-data"
                        class="org.apache.axis2.builder.MultipartFormDataBuilder"/>
        <messageBuilder contentType="text/plain"
                        class="org.apache.axis2.format.PlainTextBuilder"/>
        <messageBuilder contentType="application/octet-stream"
                        class="org.wso2.carbon.relay.BinaryRelayBuilder"/>
        <messageBuilder contentType="application/json"
                        class="org.wso2.carbon.integrator.core.json.JsonStreamBuilder"/>
</messageBuilders>

TOML configuration

[message_builders]
application_xml = "org.apache.axis2.builder.ApplicationXMLBuilder"
form_urlencoded = "org.apache.synapse.commons.builders.XFormURLEncodedBuilder"
multipart_form_data = "org.apache.axis2.builder.MultipartFormDataBuilder"
text_plain = "org.apache.axis2.format.PlainTextBuilder"
application_json = "org.wso2.micro.integrator.core.json.JsonStreamBuilder"
octet_stream =  "org.wso2.carbon.relay.BinaryRelayBuilder"

Find more parameters.

HTTP transport receiver

XML configuration

<transportReceiver name="http" class="org.apache.synapse.transport.passthru.PassThroughHttpListener">
        <parameter name="port" locked="false">8280</parameter>
        <parameter name="non-blocking" locked="false">true</parameter>
        <parameter name="bind-address" locked="false">hostname or IP address</parameter>
        <parameter name="WSDLEPRPrefix" locked="false">https://apachehost:port/somepath</parameter>      
</transportReceiver>

TOML configuration

[transport.http] 
listener.enable = true                     
listener.port = 8280    
listener.wsdl_epr_prefix ="https://apachehost:port/somepath" 
listener.bind_address = "hostname or IP address"

Find more parameters.

HTTPS transport receiver

XML configuration

<transportReceiver name="https" class="org.apache.synapse.transport.passthru.PassThroughHttpSSLListener">
    <parameter name="port" locked="false">8243</parameter>
    <parameter name="non-blocking" locked="false">true</parameter>
    <parameter name="HttpsProtocols">TLSv1,TLSv1.1,TLSv1.2</parameter>
    <parameter name="bind-address" locked="false">hostname or IP address</parameter>
    <parameter name="WSDLEPRPrefix" locked="false">https://apachehost:port/somepath</parameter>
    <parameter name="keystore" locked="false">
        <KeyStore>
            <Location>repository/resources/security/wso2carbon.jks</Location>
            <Type>JKS</Type>
            <Password>wso2carbon</Password>
            <KeyPassword>wso2carbon</KeyPassword>
        </KeyStore>
    </parameter>
    <parameter name="truststore" locked="false">
        <TrustStore>
            <Location>repository/resources/security/client-truststore.jks</Location>
            <Type>JKS</Type>
            <Password>wso2carbon</Password>
        </TrustStore>
    </parameter>
</transportReceiver>

TOML configuration

[transport.http]
listener.secured_enable = true              
listener.secured_port = 8243        
listener.secured_wsdl_epr_prefix = "https://apachehost:port/somepath"  
listener.secured_bind_address = "hostname or IP address" 
listener.secured_protocols = "TLSv1,TLSv1.1,TLSv1.2"   
listener.keystore.location ="repository/resources/security/wso2carbon.jks"
listener.keystore.type = "JKS" listener.keystore.password = "wso2carbon"
listener.keystore.key_password = "wso2carbon"
listener.truststore.location = "repository/resources/security/client-truststore.jks" 
listener.truststore.type = "JKS" listener.truststore.password = "wso2carbon"

Find more parameters.

VFS transport receiver

XML configuration

<transportReceiver name="vfs" class="org.apache.synapse.transport.vfs.VFSTransportListener"/>

TOML configuration

[transport.vfs]
listener.enable = true

Find more parameters.

Mailto transport receiver

XML configuration

<transportReceiver name="mailto" class="org.apache.axis2.transport.mail.MailTransportListener"/>    ```

TOML configuration

[transport.mail.listener]
enable = true
name = "mailto"

Find more parameters.

JMS transport receiver

XML configuration

<transportReceiver name="jms" class="org.apache.axis2.transport.jms.JMSListener">
        <parameter name="myTopicConnectionFactory" locked="false">
            <parameter name="java.naming.factory.initial" locked="false">org.apache.activemq.jndi.ActiveMQInitialContextFactory</parameter>
            <parameter name="java.naming.provider.url" locked="false">tcp://localhost:61616</parameter>
            <parameter name="transport.jms.ConnectionFactoryJNDIName" locked="false">TopicConnectionFactory</parameter>
            <parameter name="transport.jms.ConnectionFactoryType" locked="false">topic</parameter>
        </parameter>
</transportReceiver>

TOML configuration

[transport.jms] 
listener_enable = true 

[[transport.jms.listener]] 
name = "myTopicListener"
parameter.initial_naming_factory = "org.apache.activemq.artemis.jndi.ActiveMQInitialContextFactory" 
parameter.provider_url = "tcp://localhost:61616" 
parameter.connection_factory_name = "TopicConnectionFactory" 
parameter.connection_factory_type = "topic" # [queue, topic] 
parameter.cache_level = "consumer"

Find more parameters.

FIX transport receiver

XML configuration

<transportReceiver name="fix" class="org.apache.synapse.transport.fix.FIXTransportListener"/>

TOML configuration

[transport.fix] 
listener.enable = true

Find more parameters.

RabbitMQ transport receiver

XML configuration

<transportReceiver name="rabbitmq" class="org.apache.axis2.transport.rabbitmq.RabbitMQListener">
        <parameter name="AMQPConnectionFactory" locked="false">
            <parameter name="rabbitmq.server.host.name" locked="false">localhost</parameter>
            <parameter name="rabbitmq.server.port" locked="false">5672</parameter>
            <parameter name="rabbitmq.server.user.name" locked="false">guest</parameter>
            <parameter name="rabbitmq.server.password" locked="false">guest</parameter>
        </parameter>
</transportReceiver>

TOML configuration

[transport.rabbitmq] 
listener_enable = true

[[transport.rabbitmq.listener]] 
name = "AMQPConnectionFactory" 
parameter.hostname = "localhost" 
parameter.port = 5672 
parameter.username = "guest" 
parameter.password = "guest"

Find more parameters.

HTTP transport sender

XML configuration

<transportSender name="http" class="org.apache.synapse.transport.passthru.PassThroughHttpSender">
        <parameter name="non-blocking" locked="false">true</parameter>
 </transportSender>

TOML configuration

[transport.http] 
sender.enable = true

Find more parameters.

HTTPS transport sender

XML configuration

<transportSender name="https" class="org.apache.synapse.transport.passthru.PassThroughHttpSSLSender">
        <parameter name="non-blocking" locked="false">true</parameter>
        <parameter name="keystore" locked="false">
            <KeyStore>
                <Location>repository/resources/security/wso2carbon.jks</Location>
                <Type>JKS</Type>
                <Password>wso2carbon</Password>
                <KeyPassword>wso2carbon</KeyPassword>
            </KeyStore>
        </parameter>
        <parameter name="truststore" locked="false">
            <TrustStore>
                <Location>repository/resources/security/client-truststore.jks</Location>
                <Type>JKS</Type>
                <Password>wso2carbon</Password>
            </TrustStore>
        </parameter>
</transportSender>

TOML configuration

[transport.http] 
sender.secured_enable = true
sender.keystore.location ="repository/resources/security/wso2carbon.jks"
sender.keystore.type = "JKS" 
sender.keystore.password = "wso2carbon" 
sender.keystore.key_password = "wso2carbon"
sender.truststore.location = "repository/resources/security/client-truststore.jks" 
sender.truststore.type = "JKS" 
sender.truststore.password = "wso2carbon"

Find more parameters.

VFS transport sender

XML configuration

<transportSender name="vfs" class="org.apache.synapse.transport.vfs.VFSTransportSender"/>

TOML configuration

[transport.vfs]
sender.enable = true

Find more parameters.

VFS transport sender

XML configuration

<transportSender name="mailto" class="org.apache.axis2.transport.mail.MailTransportSender">
        <parameter name="mail.smtp.host">smtp.gmail.com</parameter>
        <parameter name="mail.smtp.port">587</parameter>
        <parameter name="mail.smtp.starttls.enable">true</parameter>
        <parameter name="mail.smtp.auth">true</parameter>
        <parameter name="mail.smtp.user">synapse.demo.0</parameter>
        <parameter name="mail.smtp.password">mailpassword</parameter>
        <parameter name="mail.smtp.from">synapse.demo.0@gmail.com</parameter>
</transportSender>

TOML configuration

[[transport.mail.sender]]
name = "mailto" 
parameter.hostname = "smtp.gmail.com" 
parameter.port = "587" 
parameter.enable_tls = true 
parameter.auth = true 
parameter.username = "synapse.demo.0" 
parameter.password = "mailpassword" 
parameter.from = "synapse.demo.0@gmail.com"

Find more parameters.

FIX transport sender

XML configuration

<transportSender name="fix" class="org.apache.synapse.transport.fix.FIXTransportSender"/>

TOML configuration

[transport.fix]
sender.enable = true

Find more parameters.

RabbitMQ transport sender

XML configuration

<transportSender name="rabbitmq" class="org.apache.axis2.transport.rabbitmq.RabbitMQSender"/>

TOML configuration

[transport.rabbitmq]
sender_enable = true

Find more parameters.

RabbitMQ transport sender

XML configuration

<transportSender name="jms" class="org.apache.axis2.transport.jms.JMSSender"/>

TOML configuration

[transport.jms]
sender_enable = true

Find more parameters.

Clustering

XML configuration

<clustering class="org.wso2.carbon.core.clustering.hazelcast.HazelcastClusteringAgent"
                enable="true">
<parameter name="clusteringPattern">nonWorkerManager</parameter>
</clustering>

TOML configuration

[[datasource]]
id = "WSO2_COORDINATION_DB"
url= "jdbc:mysql://localhost:3306/clusterdb"
username="root"
password="root"
driver="com.mysql.jdbc.Driver"

Find more parameters.

synapse.properties

Synapse thread pool properties:

XML configuration

synapse.threads.core = 20
synapse.threads.max = 100

TOML configuration

[mediation]
synapse.core_threads = 20
synapse.max_threads = 100

Find more parameters.

passthru-http.properties

HTTP/S worker pool properties

XML configuration

worker_pool_size_core=400
worker_pool_size_max=400
worker_pool_queue_length=-1

TOML configuration

[transport.http]
core_worker_pool_size = 400         # inferred default: 400
max_worker_pool_size = 400          # inferred default: 400
worker_pool_queue_length = -1

Find more parameters.

Preserve headers

XML configuration

http.user.agent.preserve=false
http.server.preserve=true
http.headers.preserve=Content-Type

TOML configuration

[transport.http]
preserve_http_user_agent = false
preserve_http_server_name = true
preserve_http_headers = ["Content-Type"]

Find more parameters.

jndi.properties

JMS connection factory

XML configuration

connectionfactory.QueueConnectionFactory = amqp://admin:admin@clientID/carbon?brokerlist='tcp://localhost:5675'
connectionfactory.TopicConnectionFactory = amqp://admin:admin@clientID/carbon?brokerlist='tcp://localhost:5675'

TOML configuration

[transport.jndi.connection_factories]
'connectionfactory.QueueConnectionFactory' = "amqp://admin:admin@clientID/carbon?brokerlist='tcp://localhost:5675'"
'connectionfactory.TopicConnectionFactory' = "amqp://admin:admin@clientID/carbon?brokerlist='tcp://localhost:5675'"

Find more parameters.

JMS queue
XML configuration
```
queue.JMSMS=JMSMS
```
TOML configuration
```
[transport.jndi.queue]
JMSMS = "JMSMS"
```
Find more parameters.

JMS topic

XML configuration

topic.MyTopic = example.MyTopic

TOML configuration

[transport.jndi.topic]
MyTopic = "example.MyTopic"

Find more parameters.

tasks-config.xml

XML configuration

<taskServerCount>1</taskServerCount>
<defaultLocationResolver>
    <locationResolverClass>org.wso2.carbon.ntask.core.impl.RoundRobinTaskLocationResolver</locationResolverClass>
</defaultLocationResolver>

TOML configuration

[task_handling]
resolver_class = "org.wso2.micro.integrator.ntask.coordination.task.resolver.RoundRobinResolver"

[[task_resolver]]
task_server_count = "3"

Find more parameters.

The complete list of TOML configurations for the Micro Integrator are listed in the product configuration catalog.

Migrating Log4j configurations

WSO2 ESB 5.0 (and all ESB versions prior to EI 6.6.0) use log4j. In WSO2 EI 7 Micro Integrator, the carbon.logging.jar file is not packed and the pax-logging-api is used instead. With this upgrade, the log4j version is also updated to log4j2.

Therefore, you need to follow the instructions given below to migrate from log4j (in your ESB 5.0) to log4j2 (in EI 7 Micro Integrator).

If you have used a custom log4j component in you you older EI version, apply the following changes to your component:

Replace carbon logging or commons.logging dependencies with pax-logging dependency as shown below.

<!-- Pax Logging -->
<dependency>
   <groupId>org.ops4j.pax.logging</groupId>
   <artifactId>pax-logging-api</artifactId>
   <version>${pax.logging.api.version}</version>
</dependency>
<!-- Pax Logging Version -->
<pax.logging.api.version>1.10.1</pax.logging.api.version>

If log4j dependency is directly used, apply one of the options given below.
- Replace the log4j dependency (shown below) with log4j2 and rewrite the loggers accordingly.
```
<dependency>
   <groupId>org.ops4j.pax.logging</groupId>
   <artifactId>pax-logging-log4j2</artifactId>
   <version>${pax.logging.log4j2.version}</version>
</dependency>
```
- Replace the log4j dependency with pax-logging dependency and rewrite the loggers using commons.logging accordingly.

If commons.logging is imported using Import-Package, add the version range.

org.apache.commons.logging; 
version="${commons.logging.version.range}" 
<commons.logging.version.range>[1.2.0,2.0.0)</commons.logging.version.range>

Follow the instructions on configuring log4j2 to register the Appenders and Loggers.

Migrating encrypted passwords¶

To migrate the encrypted passwords from ESB 5.0.0, you need to first obtain the plain-text passwords. Once you have them, follow the normal procedure of encrypting secrets in EI 7. See Encrypt Secrets for instructions.

In case you need to obtain the plaintext passwords from the encrypted passwords in the WSO2 ESB 5.0.0, you can use the password decryption tool.

Follow the instructions given below to use the password decryption tool.

Download the tool.
Copy the org.wso2.mi.migration-1.2.0.jar into the ESB_HOME/repository/components/dropins folder in the server.
Create a directory named migration in ESB_HOME.
Copy the migration-conf.properties file into the migration directory, and update the following property.

Property Description

admin.user.name The user name of the system administrator.
Start the server using the migrate.from.product.version system property as follows:
On Linux/Unix
```
sh wso2server.sh -Dmigrate.from.product.version=esb
```
On Windows
```
wso2server.bat -Dmigrate.from.product.version=esb
```
Info

Upon successful execution, the decrypted (plain-text) values in the secure-vault.properties and cipher-text.properties files will be written respectively to the <ESB_HOME>/migration/secure-vault-decrypted.properties file and the <ESB_HOME>/migration/cipher-text-decrypted.properties file in ESB 5.0.0.

The encrypted passwords are now decrypted and you have access to the plain-text password values.

Top