| Apache Synapse Enterprise Service Bus (ESB) - 1.1.1 Release Notes - January 2008 |
| |
| 1. Overview |
| The Apache Synapse ESB is a robust, lightweight and highly scalable and distributed |
| Enterprise Service Bus (ESB). It supports SOAP Web services as well as Legacy services over |
| transports such as JMS, Apache VFS File systems, Mail etc, and SOAP, REST/POX, plain text |
| and binary message payloads. |
| |
| Apache Synapse graduated from the Apache Incubator on the 2nd of January 2007, and the first |
| Synapse 1.0 was released on the 11th of June 2007. On the 20th of December 2007, Synapse was |
| accepted as a top level project (TLP) under the Apache Software Foundation. |
| |
| 2. Installation Prerequisites |
| |
| Apache Synapse requires a J2SE runtime of version 1.5.x or later and Apache Ant to run the samples. |
| Synapse requires JDK 1.5.x at runtime as it uses a NIO based https implementation, that is only |
| possible with a JDK 1.5.x or later. To build Synapse from source, you will need JDK 1.5.x, and |
| Apache Maven 2.0.6 or later |
| |
| 3. Quick start |
| Please see the docs/Synapse_Quickstart.html guide |
| |
| 4. Building the Samples |
| Please see the documents docs/Synapse_Samples.html and docs/Synapse_Samples_Setup.html |
| |
| 5. Synapse configuration language |
| Please see the document docs/Synapse_Configuration_Language.html |
| |
| 6. Extending Synapse |
| Please see the document docs/Synapse_Extending.html |
| |
| 7. Known Issues and limitations |
| |
| * SYNAPSE-180 Does not support the ability to throttle by concurrency within a cluster |
| * SYNAPSE-174 The non-blocking http/s transports cannot handle WS-RM requests |
| * SYNAPSE-186 Does not support PUT/DELETE rest operations |
| * SYNAPSE-215 XSLTMediator doesn't handle text output correctly |
| * SYNAPSE-212 XSLTMediator doesn't close/delete temporary files properly |
| |
| * The Synapse JMS implementation supports JMS 1.0.2b, however due to licensing issues we include |
| the JMS 1.1 spec JAR from Apache Geronimo (geronimo-jms_1.1_spec-1.1.jar) instead. If you have |
| any issues with JMS 1.0.x, please download the Sun JMS 1.0.2b JAR and replace supplied JAR from |
| Geronimo. |
| |
| 8. Frequently asked questions |
| |
| * How can I change the default logging level of Synapse? |
| Edit the lib/log4j.properties and set the line "log4j.category.org.apache.synapse=INFO" to |
| "log4j.category.org.apache.synapse=DEBUG" and restart Synapse. |
| |
| * If you get an error related to WS-Security or when using it, check to ensure that your JDK |
| uses the "Unlimited Strength Jurisdiction Policy Files". These could be downloaded from |
| http://java.sun.com/javase/downloads/index_jdk5.jsp Refer to the associated documentation |
| for instructions on how to install it to your JDK. |
| |
| * If you encounter issues with your JDK related to XML processing, try placing the Xerces jar |
| files xercesImpl-2.8.0.jar and xml-apis-1.3.03.jar in your <JDK>/jre/lib/endorsed/ directory. |
| |
| 9. Reporting Problems |
| |
| Please use Apache's JIRA system (http://issues.apache.org/jira/) to report issues you find. |
| You may also join the: |
| synapse-dev mailing list by sending email to synapse-dev-subscribe@ws.apache.org |
| synapse-user mailing list by sending email to synapse-user-subscribe@ws.apache.org |
| |
| 10. New features |
| The 1.1.1 release |
| * Clustering support for the Cache/Throttle Mediators |
| * Maintainance mode support for the HTTP transport |
| * New Mail transport that supports POP3/IMAP/SMTP |
| * JMX Monitoring support |
| * Callout Mediator |
| * Improved JMS/VFS transports |
| * Improved REST/POX support |
| * Annotations support for POJOCommand mediator |
| * Ability to pin a proxy or a task to server instances |
| |
| |
| The 1.1 release |
| * Apache VFS based file transport |
| * Scheduled Task support |
| * XQuery mediator |
| * POJO Command mediator |
| * DB Report and DB Lookup mediators |
| * Cache and Throttle mediators/enhancements |
| * Split/Clone/Aggregate mediators |
| * Improved logging and tracing support |
| |
| The 1.0 release |
| * Non blocking HTTP and HTTPS transport based on Apache HttpCore/NIO |
| * Enhanced Proxy services with in/out/fault sequences and endpoints, inline sequence and WSDL |
| support |
| * WSDL endpoints |
| * Load balancing and Failover endpoints |
| * Throttling mediator |
| |
| The 0.91 release adds support for: |
| * WS-Reliable Messaging Sequence management |
| |
| The 0.90 release adds support for: |
| * WS-Security termination and initiation |
| * WS-ReliableMessaging termination and initiation |
| * Support for dynamic reloading and remote reigstries |
| * Scripting mediators based on Apache BSF |
| * Refactored and cleaner synapse configuration xml |