This documentation is for WSO2 Enterprise Integrator version 6.5.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 can tune the Java Virtual Machine (JVM) settings to make a production system more efficient. 

You can configure the JVM parameters in the <EI_HOME>/bin/integrator.bat file (on Windows) or the <EI_HOME>/bin/ file (on Linux/Solaris). Following are the most important JVM parameters you need to configure:

  • Maximum Heap Memory Allocation (Xmx) - This parameter sets the maximum heap memory allocated for the JVM. Increasing the memory allocation increases the memory available for the server, which results in increasing the maximum TPS and reducing the latency. We recommend al least 2 GB of heap memory allocation for instances.
    For example, If you want to set 2 GB as the maximum heap memory size, you need to configure the parameter as follows:

    -Xms2048m -Xmx2048m

    Here, Xmx is the maximum memory allocation pool for a JVM. Xms is the initial memory allocation pool.

  • Metaspace size - In JDK 1.8.*, class metadata is stored in the native heap, and this space is called Metaspace. By default class metadata allocation is only limited by the amount of available native memory. If you need to limit the amount of native memory used for class metadata, you need to set MaxMetaspaceSize.
    To ensure stability of a production system, you can set the MaxMetaspaceSize parameter to 1GB as follows:


When an XML element has a large number of sub elements and the system tries to process all the sub elements, the system can become unstable due to a memory overhead. This is a security risk.

To avoid this issue, you can define a maximum level of entity substitutions that the XML parser allows in the system. You do this using the entity expansion limit as follows in the <EI_HOME>/bin/integrator.bat file (for Windows) or the <EI_HOME>/bin/ file (for Linux/Solaris). The default entity expansion limit is 64000.


In a clustered environment, the entity expansion limit has no dependency on the number of worker nodes.

  • No labels