This documentation is for WSO2 Enterprise Service Bus version 5.0.0. For the latest ESB, view the latest WSO2 Enterprise Integrator documentation.

All docs This doc
Skip to end of metadata
Go to start of metadata

What is new in this release

WSO2 ESB version 5.0.0 is the successor of version 4.9.0, and it comes complete with the runtime, tooling, and analytics in a single release. 

WSO2 ESB 5.0.0 contains the following new features and enhancements:

What has changed in this release

This release includes a few features and functionalities that are deprecated and might be removed in a future release as well as some features and functionalities that are removed.

Deprecated features and functionalities

Removed features and functionalities

  • The Axis2 Quality of Services UI to apply security policies, throttling and caching has been removed from the management console. For information on how to apply security, throttling and caching, see the following:
    • The recommended approach to apply security to a proxy service is via WSO2 ESB tooling. For instructions on the process of applying security to a proxy service, see Applying Security to a Proxy Service.
    • The recommended approach to enable throttling is to use the throttle mediator.
    • The recommended approach to enable caching is to use the cache mediator.
  • The EHcache based implementation has been removed from ESB 4.9.0 and above due to distributed caching related issues with EHcache. We have moved onto a hazelcast based caching implementation with ESB 4.9.0 onwards, and officially support the hazelcast based caching implementation.


    The EHCache jar that was shipped with ESB 4.8.1 and older versions under the <ESB_HOME>/repository/components/plugins directory is not shipped with ESB 4.9.0 and later. If you do want to use a third party jar like EHCache jar with ESB 4.9.0 and above, you can add the jar to the <ESB_HOME>/repository/components/lib directory.

Compatible WSO2 product versions

WSO2 ESB 5.0.0 is based on WSO2 Carbon 4.4.8 and is expected to be compatible with any WSO2 product that is based on the same Carbon version. If you come across any compatibility issues, contact team WSO2. For information on the third-party software required for running the ESB and its samples, see Installation Prerequisites.

Fixed issues

This release includes several bug fixes.

Known issues

This release includes several known issues.

There is a known issue related to preserving CDATA blocks when you send CDATA inside a SOAP message payload. As a temporary workaround, you can add the file with the following property to the <ESB_HOME> directory.

When you set this property to false, it can cause an issue in uploading CAR files from the Management Console. Therefore, if you need to upload a CAR file after adding the file as specified above, you can either copy the CAR file directly to the <ESB_HOME>/repository/deployment/server/carbonapps directory or you can upload it via WSO2 Developer Studio 3.7.1 and later versions.

For a complete list of known issues in this release, see WSO2 ESB - Open Issues.


  • No labels