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.

Note

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.

Setting up

  • 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:

    Tip

    The home directory of your Micro Integrator will be referred to as <MI_HOME> from hereon.

  • Use WSO2 Updates to get the latest available updates for your Micro Integrator distribution.

    Info

    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 deployment.toml file.

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:

  1. Download the database migration scripts.

  2. Unzip the downloaded file and select the script relevant to your database type.

  3. 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 deployment.toml file.

Step 2 - Connect to the user store

To connect the Micro Integrator to the primary user store:

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.

Migrating artifacts

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.

Migrating keystores

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.

Migrating configurations

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