Upgrading from WSO2 EI 7.1.x to WSO2 API-M 4.0.0¶
This guide explains the recommended strategy for upgrading from the Micro Integrator of WSO2 EI 7.1.0 to the Micro Integrator of WSO2 API-M 4.0.0.
Because there aren't any database changes between the Micro Integrators of EI 7.1.0 and API-M 4.0.0, upgrading involves moving (migrating) all your artifacts and configurations from EI 7.1.0 to API-M 4.0.0.
- Make a backup of the databases used by the current EI 7.1.x deployment. This backup is necessary in case the migration causes any issues in the existing database.
Download and install the latest Micro Integrator in your environment:
The home directory of your Micro Integrator will be referred to as
Use WSO2 Updates to get the latest available updates for your Micro Integrator distribution.
Note that you need a valid WSO2 subscription to use updates in a production environment.
Migrating the user store¶
If you are using an LDAP user store with EI 7.1.0, you can simply connect the same to the Micro Integrator of API-M 4.0.0 by updating the configuration details in the Micro Integrator's
If you are using a JDBC user store with EI 7.1.0, you need to first update the database before connecting the same to APIM 4.0.0.
Follow the steps given below.
Step 1 - Update the database structure¶
This step is applicable only if your user store is JDBC.
There are changes in the database structure (schema) that is used in EI 7.1.0. To update the database schema:
Download the database migration scripts.
Unzip the downloaded file and select the script relevant to your database type.
Connect to the database and run the script.
Your database schema is now updated for APIM 4.0.0. Now you can update the configuration details in the Micro Integrator's
Step 2 - Connect to the user store¶
To connect the Micro Integrator to the primary user store:
- configuring an LDAP user store for the Micro Integrator in API-M 4.0.0.
- configuring an RDBMS user store for the Micro Integrator in API-M 4.0.0.
Migrating the registry¶
The Micro Integrator uses a file-based registry. You can directly migrate the artifacts to the Micro Integrator of API-M 4.0.0 by copying the carbon applications from the
<MI_HOME>/repository/deployment/server/carbonapps folder in the Micro Integrator of EI 7.1.0 to the same folder in API-M 4.0.0.
Copy the contents inside the
<MI_HOME>/repository/deployment folder in the Micro Integrator of EI 7.1.0 to the same folder in API-M 4.0.0.
Migrating custom components¶
Copy the jars inside the
<MI_HOME>/dropins folder in the Micro Integrator of EI 7.1.0 to the same folder in API-M 4.0.0. The custom JARs can be copied to the
<MI_HOME>/lib folder in API-M 4.0.0.
Copy the JKS files from the
<MI_HOME>/repository/resources/security folder in the Micro Integrator of EI 7.1.0 to the same folder in API-M 4.0.0.
Copy the configurations in the
deployment.toml file of the Micro Integrator of EI 7.1.0 (such as database, transport, datasource configurations, etc.) to the
deployment.toml file of the Micro Integrator in API-M 4.0.0.
Migrating Hl7 Transport¶
HL7 transport is not shipped by default in the API-M 4.0.0 Micro Integrator distribution. Therefore, the jars need to be added to the Micro Integrator server manually. See Configuring the HL7 transport for details.Top