Upgrading from WSO2 Data Services Server

This page walks you through the process of upgrading to WSO2 Enterprise Integrator (WSO2 EI) 6.0.0 from WSO2 Data Services Server (WSO2 DSS) 3.5.1.

If you are upgrading from a version older than WSO2 DSS 3.5.1, you will need to first upgrade to WSO2 DSS 3.5.1 and then upgrade to WSO2 EI 6.0.0.

For information on the default ports in WSO2 EI runtimes, see Default ports of WSO2 EI.
The distribution folder structure has changed from WSO2 DSS 3.5.1 to WSO2 EI 6.0.0. The changes in the folder structure for directory locations of the configuration related files are as follows:

Enterprise Service Bus 5.0.0	Enterprise Integrator 6.0.0
`<DSS_HOME>/repository/conf`	`<EI_HOME>/conf`
`<DSS_HOME>/repository/conf/axis2`	`<EI_HOME>/conf/axis2`
`<DSS_HOME>/repository/conf/datasources`	`<EI_HOME>/conf/datasources`
`<DSS_HOME>/repository/components/dropins`	`<EI_HOME>/dropins`
`<DSS_HOME>/repository/components/extensions`	`<EI_HOME>/extensions`
`<DSS_HOME>/repository/components/lib`	`<EI_HOME>/lib`

Migrating the database

When upgrading to WSO2 EI 6.0.0, you can use the same database you used for WSO2 DSS 3.5.1. Follow the steps below to configure WSO2 EI 6.0.0 database to connect to WSO2 DSS 3.5.1 database:

Copy database connector .jar files from <DSS_HOME>/repository/components/lib to <EI_HOME>/lib directory. For example, the ojdbc7.jar for the Oracle database can be copied here.
Copy <DSS_HOME>/repository/conf/datasources/master-datasources.xml file to <EI_HOME>/conf/datasources directory. This will upgrade the database configuration in WSO2 EI 6.0.0.
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. The following are sample configurations if the datasource is jdbc/WSO2CarbonDB:

registry.xml
```
<dbConfig name="wso2registry">
<dataSource>jdbc/WSO2CarbonDB</dataSource>
</dbConfig>
```
usermgt.xml
```
<UserManager>
<Realm>
<Configuration>
...
  <Property 
     name="dataSource">jdbc/WSO2CarbonDB</Property>
</Configuration>
...
</Realm>
</UserManager>
```

Migrating configuration files

Check for any configurations that were done for WSO2 DSS 3.5.1 based on your solution and update the following configuration files in EI 6.0.0 accordingly:

- axis2.xml
- axis2_client.xml
- carbon.xml

Migrating tenant artifacts

Copy the tenant directory packages from <DSS_HOME>/repository/tenants to <EI_HOME>/repository/tenants directory.

Starting the server

Once you have completed the migration, you can start the WSO2 EI runtime. For details see Running the Product.