This documentation is for WSO2 Enterprise Integrator version 6.1.0 . View documentation for the latest release in the 6.x.x family and the latest release in the 7.x.x family.

All docs This doc
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 12 Next »

This page walks you through the process of upgrading to WSO2 Enterprise Integrator (WSO2 EI) 6.1.0 from WSO2 Enterprise Service Bus (WSO2 ESB) 5.0.0.

If you are upgrading from a version older than ESB 5.0.0, you should first upgrade to ESB 5.0.0 and then upgrade to WSO2 EI 6.1.0.

  • For information on the default ports in WSO2 EI profiles, see Default ports of WSO2 EI.
  • The distribution folder structure has changed from ESB 5.0.0 to WSO2 EI 6.1.0. The changes in the folder structure for directory locations are as follows:

    Enterprise Service Bus 5.0.0Enterprise Integrator 6.1.0


See the following topics for instructions:

Upgrading the database

In WSO2 EI 6.1.0, you can use the same Carbon database that you used for WSO2 ESB 5.0.0. Therefore, you can simply restore the backup of the existing Carbon databases to use with WSO2 EI 6.1.0.

Migrating the configurations

 Configurations should not be copied directly between servers.

Follow the steps give below to migrate the configurations from WSO2 ESB 5.0.0 to the Integration profile of WSO2 EI 6.1.0.

  1. Copy the database connector JAR files stored in the <ESB_HOME>/repository/components/lib directory to the <EI_HOME>/lib directory.
  2. Copy the keystores and truststores used in the WSO2 ESB 5.0.0 from the <ESB_HOME>/repository/resources/security directory to the <ESB_HOME>/repository/resources/security directory in WSO2 EI 6.1.0.
  3. Update the configuration files:
    1. Update the configuration files with information of the migrated keystores and truststores. See Configuring Keystores in WSO2 products for more information.
    2. Go to the <EI_HOME>/conf/datasources directory and update the Carbon datasource configuration in the master-datasources.xml file with the details of the Carbon database.
    3. Go to the <EI_HOME>/conf directory and update the datasource references in the user-mgt.xml and registry.xml files to match the updated configurations in the master-datasources.xml file.

  4. If you have secondary user stores created for WSO2 ESB 5.0.0, you need to copy the 'userstore' folder in the <ESB_HOME>/repository/deployment/server/ directory to the the <ESB_HOME>/repository/deployment/server/ directory in WSO2 EI 6.1.0.
  5. If there are any third-party libraries used with WSO2 ESB 5.0.0 that you want to migrate, copy the relevant libraries to WSO2 EI 6.1.0: 
    • If you have used JMS libraries, JDBC libraries, etc., copy the files from <ESB_HOME>/repository/components/lib directory to <EI_HOME>/lib directory.
    • If you have used OSGi bundles such as SVN kit etc., copy the contents of <ESB_HOME>/repository/components/dropins directory to <EI_HOME>/dropins directory.
  6. Check for any other configurations that were done for WSO2 ESB 5.0.0 based on your solution, and update the configurations in WSO2 EI 6.1.0 accordingly. For example, configurations related to external user stores, caching, mounting, transports, etc.


    The following files have changed from ESB 5.0.0 to EI 6.1.0:

    • axis2.xml
    • axis2_nhttp.xml
    • axis2_pt.xml
    • tenant-axis2.xml
    • cache.xml
    • config-validation.xml
    • osgi-debug.option
    • cloud-services-desc.xml
    • authenticators.xml
    • catalina-server.xml
    • carbon.xml
    • identity.xml
    • synapse-handlers.xml
    • user-mgt.xml

    Do not copy and paste the configuration files as there are some changes from ESB 5.0.0 to EI 6.1.0. You need to update the configuration files based on the usage.

Migrating configurations of ESB Analytics to the Analytics profile of WSO2 EI

If you want to connect your EI Analytics 6.1.0 installation to the same databases that were used with your previous Analytics installation, update the configurations in the <EI_HOME>/wso2/analytics/conf/analytics/rdbms-config.xml file according to the configurations in the same file of your previous Analytics installation.

Migrating artifacts

You should manually deploy the Composite Application Archive (CAR) files that you have in WSO2 ESB 5.0.0 to WSO2 EI 6.1.0. If you have a mediator packed in a CAR, all the artifacts using that mediator should also be included in the same CAR. See Deploying Composite Applications in the Server in the WSO2 Admin Guide for further details.

  • To migrate deployment artifacts including message flow configurations, copy the required Synapse artifacts from the <ESB_HOME>/repository/deployment/server/synapse-configs/default directory of WSO2 ESB 5.0.0 to WSO2 EI 6.1.0.
  • To migrate any connector artifacts, copy the JARs from the <ESB_HOME>/repository/deployment/server/synapse-configs/default/synapse-libs and <ESB_HOME/repository/deployment/server/synapse-configs/default/imports directories in WSO2 ESB 5.0.0 to the same directories in WSO2 EI 6.1.0.
  • If you have custom artifacts created in the <ESB_HOME>/repository/deployment/server/ directory of WSO2 ESB 5.0.0, copy them to the same directory in WSO2 EI 6.1.0.

If you have created a messages store in your configuration and configured the provider path as repository/conf/ in your ESB 5.0.0 instance, this needs to be updated with the file path in EI 6.1.0. To do this, edit the message store artifact so that the provider path is configured as conf/

Migrating tenant artifacts

If multi-tenancy is used, copy the tenant artifacts from <ESB_HOME>/repository/tenants directory from ESB 5.0.0 to EI 6.1.0.

You may not be able to access the tenant domain after migrating to EI 6.1.0. To fix this issue, change the tenant’s main sequence located in <EI_HOME>/repository/tenants/1/synapse-configs/default/sequences/main.xml as below:

<sequence xmlns="" name="main">
  • No labels