This documentation is for WSO2 Enterprise Integrator version 6.3.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

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

Microservices are designed to start up very quickly, perform a specific task, and then shut down. The Micro Integrator profile (MI profile) of WSO2 Enterprise Integrator (WSO2 EI is architectured to be container-firndly so that it allows you to perform advanced scenarios without sacrificing the speed required for a container-based architecture. Because ) is designed in a highly container-friendly manner, and thereby, it is ideal for you to use it for Microservices Architecture (MSA)-based solutions, which are deployed in container-based environments. Because its start-up time is faster than the ESB profile, Microservices are designed to start up very quickly, perform a specific task, and then shut down. Also, you can use the Micro Integrator prfile to orchestrate atomic microservices into composite microservices that address more complex, real-world scenariosthe Micro Integrator profile allows you to perform advanced integration scenarios without sacrificing the speed required for a container-based deployment architecture

For information on what the Micro Integrator Profile profile brings with this release, see About this Release.

Table of Contents

Running the Micro Integrator profile

For instructions, see Starting the Micro Integrator profile.


By default, the Micro Integrator profile runs with a port offset of 10, which means that the default HTTP listener port is 8290 and the default HTTPS listener port is 8253.

Deploying artifacts in the Micro Integrator profile

After creating your artifacts in an ESB Solutions Project via WSO2 EI Tooling, import the project as a Composite Application, and add the CAR file to the <EI_HOME>/wso2/microIntegrator/repository/deployment/server/carbonapps directory to deploy it.


Restart the Micro Integrator profile after deploying the artifacts.


All configuration files related to the Micro Integrator profile are located ain in the <EI-HOME>/wso2/micro-integrator/conf directory. For more information, go to Directory Structure of WSO2 Products in the WSO2 Administration Guide.


The H2 database-based registry is not available in the Micro Integrator profile. Instead, it has a file - system - based registry, which provides the same functionality. Thus, by default, the <EI_HOME>/wso2/micro-integrator/registry directory will act as the registry to store registry artifacts etc. This main registry directory will consist of the following sub-registry directories.


These sub-registry directories will be created automatically when you deploy registry artifacts. If you did not deploy any registry artifacts, you can create them manually.

  • Local: To store local artifacts of the product server that are not shared with the other products in the deployment.
  • Config: To store all product-specific artifacts that are shared between similar product instances.
  • Governance: To store all artifacts that re are relevant to the governance of the product.

If you want to change the default locations of the Registry registry directories, uncomment and change the following configuration in the <EI_HOME>/wso2/microIntegrator/repository/deployment/server/synapse-config/default/directoryregistry.xml file.

Code Block
<registry xmlns="" provider="org.wso2.carbon.mediation.registry.MicroIntegratorRegistry">
    <parameter name="cachableDuration">15000</parameter>
        Uncomment below parameters (ConfigRegRoot, GovRegRoot, LocalRegRoot) to configure registry root paths
        Default : <EI_HOME>/wso2/micro-integrator/registry/{governance | config | local}
    <parameter name="ConfigRegRoot">{Root directory path for configuration Registry}</parameter>
    <parameter name="GovRegRoot">{Root directory path for governance Registry}</parameter>
    <parameter name="LocalRegRoot">{Root directory path for local Registry}</parameter>

Trying out a sample scenario

For instrcutions on trying out a simple use case using the micro Integrator proifle, see Sending a Simple Message to a Service Using the Micro Integrator.