About this Release

What is new in this release

WSO2 ESB version 4.9.0 is the successor of version 4.8.1. It contains the following new features and enhancements:

• Inbound endpoints that support transports to work in multi-tenant environments. The following inbound protocols are introduced with this release.
  • HTTP Inbound Protocol.
  • HTTPS Inbound Protocol.
  • File Inbound Protocol.
  • JMS Inbound Protocol.
  • HL7 Inbound Protocol.
  • Kafka Inbound Protocol
  • CXF WS-RM Inbound Protocol.
  • MQTT Inbound Protocol.
  • RabbitMQ Inbound Protocol.
• Ability to create custom inbound endpoints for scenarios that require functionality not provided by the existing inbound endpoints.
• A connector store with over 100 connectors that you can download and connect to, in order to interact with functionality and data of various third party products. To browse through the complete list of WSO2 ESB connectors and for information on configuring operations for each connector, see WSO2 ESB Connectors Documentation.
• Coordination support for message stores and processors.
• For-each mediator.
• Publish event mediator.
• JDBC message store to store and retrieve messages efficiently. 
• Improved RabbitMQ transport. See, RabbitMQ AMQP Transport.
• Dynamic SSL profiles for sender and listener. See, Multi-HTTPS Transport.
• Coordination support for scheduled tasks.
• Support for client side HTTP cache control using Etag. 

• transport.jms.RetriesBeforeSuspension and transport.jms.PollingSuspensionPeriod parameters are introduced to the JMS Inbound Protocol with the WUM update released on the 9th of January 2018:

  You can deploy a WUM update into production only if you have a paid subscription. If you do not have a paid subscription, you will be able to use the new parameters when the next version of the product is released.
  For information on how to update your pack using WUM, see Getting Started with WUM.

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

• Before the 4.8.0 release, the Transport Management feature allowed you to override transport configuration at runtime using the ESB management console. Because changing transports at runtime can lead to server instability and is not a recommended practice, this feature was deprecated in 4.8.0. For information on configuring transports, see Configuring Transports.
• Mediation libraries were replaced by connectors in 4.8.0.

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 with ESB 4.9.0, see the following:
  • The recommended approach to apply security to a proxy service is via WSO2 Developer Studio. 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 due to distributed caching related issues with EHcache. We have moved onto a hazelcast based caching implementation with ESB 4.9.0, and officially support hazelcast based caching implementation.

  Note

  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. If you do want to use the EHCache jar, which is a third party jar with ESB 4.9.0, you can add the jar to the <ESB_HOME>/repository/components/libs directory.

Compatible WSO2 product versions

Following are the products tested for compatibility with WSO2 ESB 4.9.0:

• WSO2 Identity Server 5.0.0
• WSO2 Business Activity Monitor 2.5.0

WSO2 ESB 4.9.0 is based on WSO2 Carbon 4.4.0 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.

For a complete list of issues fixed in this release, see WSO2 ESB 4.9.0 - Fixed Issues.

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 XMLInputFactory.properties file with the following property to the <ESB_HOME> directory.

javax.xml.stream.isCoalescing=false

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 XMLInputFactory.properties 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.