You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@synapse.apache.org by as...@apache.org on 2007/04/27 15:54:17 UTC
svn commit: r533099 - in /webservices/synapse/trunk/java/src:
main/release/README.txt main/release/docs/release_notes.txt
site/resources/Synapse_Samples.html site/resources/Synapse_Samples_Setup.html
Author: asankha
Date: Fri Apr 27 06:54:16 2007
New Revision: 533099
URL: http://svn.apache.org/viewvc?view=rev&rev=533099
Log:
update readme.txt and release_notes.txt and typo and updates to docs
Modified:
webservices/synapse/trunk/java/src/main/release/README.txt
webservices/synapse/trunk/java/src/main/release/docs/release_notes.txt
webservices/synapse/trunk/java/src/site/resources/Synapse_Samples.html
webservices/synapse/trunk/java/src/site/resources/Synapse_Samples_Setup.html
Modified: webservices/synapse/trunk/java/src/main/release/README.txt
URL: http://svn.apache.org/viewvc/webservices/synapse/trunk/java/src/main/release/README.txt?view=diff&rev=533099&r1=533098&r2=533099
==============================================================================
--- webservices/synapse/trunk/java/src/main/release/README.txt (original)
+++ webservices/synapse/trunk/java/src/main/release/README.txt Fri Apr 27 06:54:16 2007
@@ -1,5 +1,5 @@
-Apache Synapse 1.0 build (May 2007) - http://ws.apache.org/synapse/
-------------------------------------------------------------------------------------------
+Apache Synapse 1.0 build (May 2007) - http://ws.apache.org/synapse/
+------------------------------------------------------------------------------------------
-------------------
First Steps
@@ -32,55 +32,57 @@
axis2Server.sh
axis2Server.bat
/src/
- <sample services source>
+ <sample services source>
You could start Synapse using the bin/synapse.sh or bin/synapse.bat script, which will load
the configuration found in repository/conf/synapse.xml. To configure the underlying Axis2
SOAP engine (e.g. to enable JMS) you need to configure the repository/conf/axis2.xml. To
configure logging levels and to turn on/off debug level logging, please configure the
-lib/log4j.properties file, and set the line "log4j.category.org.apache.synapse=DEBUG" as
-"log4j.category.org.apache.synapse=INFO"
+lib/log4j.properties file, and set the line "log4j.category.org.apache.synapse=INFO" as
+"log4j.category.org.apache.synapse=DEBUG" to turn on debug logging.
--------------------
-Documentation
-===================
-
+-------------------
+Documentation
+===================
+
Documentation can be found in the 'docs' directory included with the binary distribution
-and in the 'src/site/resources' directory in the source distribution.
-
+and in the 'src/site/resources' directory in the source distribution.
+
For Synapse mediation samples please see the Synapse_Quickstart.html, Synapse_Samples.html
-and Synapse_Samples_Setup.html
-
-For more information on the Synapse Configuration language syntax and useage refer to
-Synapse_Configuration_Language.html
-
--------------------
-Getting Started
-===================
-
+and Synapse_Samples_Setup.html
+
+For more information on the Synapse Configuration language syntax and useage refer to
+Synapse_Configuration_Language.html
+
+-------------------
+Getting Started
+===================
+
Refer to the Synapse_Quickstart.html document to get started with Synapse in just a couple of minutes.
More indepth samples could be found in Synapse_Samples_Setup.html and Synapse_Samples.html found in
-the docs directory.
-
-The actual sample Synapse configurations could be found at <SYNAPSE>/respository/conf/sample.
-The resources sub-directory contains the sample XSLT transformations, XSD schemas, WS policies
-and all other resources required to demonstrate various aspects of Synapse.
-
--------------------
-Support
-===================
-
-Any issues with this release can be reported to Apache Synapse mailing list or in the JIRA issue tracker.
-
-Mailing list subscription:
+the docs directory.
+
+The actual sample Synapse configurations could be found at <SYNAPSE>/respository/conf/sample.
+The resources sub-directory contains the sample XSLT transformations, XSD schemas, WS policies
+and all other resources required to demonstrate various aspects of Synapse.
+
+-------------------
+Support
+===================
+
+Please refer to the release_notes.txt file for information on commons issues and the solutions.
+
+Any issues with this release can be reported to Apache Synapse mailing list or in the JIRA issue tracker.
+
+Mailing list subscription:
synapse-dev-subscribe@ws.apache.org
- synapse-user-subscribe@ws.apache.org
-
-Jira:
- http://issues.apache.org/jira/browse/Synapse
-
-Thank you for using Synapse!
-The Synapse Team.
+ synapse-user-subscribe@ws.apache.org
+
+Jira:
+ http://issues.apache.org/jira/browse/Synapse
+
+Thank you for using Synapse!
+The Synapse Team.
Modified: webservices/synapse/trunk/java/src/main/release/docs/release_notes.txt
URL: http://svn.apache.org/viewvc/webservices/synapse/trunk/java/src/main/release/docs/release_notes.txt?view=diff&rev=533099&r1=533098&r2=533099
==============================================================================
--- webservices/synapse/trunk/java/src/main/release/docs/release_notes.txt (original)
+++ webservices/synapse/trunk/java/src/main/release/docs/release_notes.txt Fri Apr 27 06:54:16 2007
@@ -1,48 +1,73 @@
Apache Synapse 1.0 Release Notes
1. Overview
-The Synapse project is a robust, lightweight implementation of a highly scalable and distributed
-service mediation framework based on Web services and XML specifications.
+ The Synapse project is a robust, lightweight implementation of a highly scalable and distributed
+ service mediation framework based on Web services and XML specifications.
-Apache Synapse graduated from the Apache Incubator on the 2nd of January 2007
-
-Please see http://ws.apache.org/synapse/
+ Apache Synapse graduated from the Apache Incubator on the 2nd of January 2007
+ Please see http://ws.apache.org/synapse/ for more information
2. Installation Prerequisites
-Apache Synapse requires a J2SE runtime of version 1.4.2 or later for runtime. However, to build
-Synapse from source, you will need JDK 1.5 or later and Apache Maven 2.0.6
+
+ Apache Synapse requires a J2SE runtime of version 1.4.2 or later for runtime. However if the
+ https (SSL) transport is being used, Synapse requires JDK 1.5 as it uses a NIO based https
+ implementation, that is only possible with a JDK 1.5 or later (refer to the Quick start guide
+ for information on how to disable https). To build Synapse from source, you will need JDK 1.5
+ or and Apache Maven 2.0.6
3. Quick start
-Please see the docs/Synapse_Quickstart.html guide
+ 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
+ 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
-3. Synapse configuration language
-Please see the document docs/Synapse_Configuration_Language.html
+6. Known Issues
-4. Known Issues
+7. Frequently asked questions
-5. 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
-
-6. New features
-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
+ * java.lang.UnsupportedClassVersionError: ... (Unsupported major.minor version 49.0)
+ This error would occur if you try to use the https transport (enabled by default) with a JDK
+ version earlier than 1.5. Refer the Quick start guide to find out how the https transport
+ could be disabled.
+
+ * 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.
+
+
+8. 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
+
+9. New features
+
+ 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
Modified: webservices/synapse/trunk/java/src/site/resources/Synapse_Samples.html
URL: http://svn.apache.org/viewvc/webservices/synapse/trunk/java/src/site/resources/Synapse_Samples.html?view=diff&rev=533099&r1=533098&r2=533099
==============================================================================
--- webservices/synapse/trunk/java/src/site/resources/Synapse_Samples.html (original)
+++ webservices/synapse/trunk/java/src/site/resources/Synapse_Samples.html Fri Apr 27 06:54:16 2007
@@ -1076,7 +1076,7 @@
uses this knowledge to transform the response back to the client in the same
format as the original request.</p>
-<p>When the client executes successfully, it will upload a file containging
+<p>When the client executes successfully, it will upload a file containing
the ASF logo and receive its response back again and save it into a temporary
file.</p>
<pre>[java] Sending file : ./../../repository/conf/sample/resources/mtom/asf-logo.gif as MTOM</pre>
Modified: webservices/synapse/trunk/java/src/site/resources/Synapse_Samples_Setup.html
URL: http://svn.apache.org/viewvc/webservices/synapse/trunk/java/src/site/resources/Synapse_Samples_Setup.html?view=diff&rev=533099&r1=533098&r2=533099
==============================================================================
--- webservices/synapse/trunk/java/src/site/resources/Synapse_Samples_Setup.html (original)
+++ webservices/synapse/trunk/java/src/site/resources/Synapse_Samples_Setup.html Fri Apr 27 06:54:16 2007
@@ -1,10 +1,9 @@
<html>
<head>
- <meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
+ <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
<title>Apache Synapse Samples</title>
- <meta name="generator" content="Amaya 9.54, see http://www.w3.org/Amaya/" />
-
-<style type="text/css">
+ <meta name="generator" content="Amaya 9.54, see http://www.w3.org/Amaya/">
+ <style type="text/css">
.command {
border: 1px dashed #3c78b5;
text-align: left;
@@ -98,8 +97,7 @@
background-color: #f0f0f0;
padding: 2px;
margin: 18px 0px 4px 0px;
- }
-</style>
+ }</style>
</head>
<body>
@@ -120,6 +118,15 @@
ActiveMQ installation by default (or another JMS provider with configuration)
and any https examples would require a JDK version 1.5 or later.</p>
+<p></p>
+
+<p>Note*: The samples and the documentation assumes that you are running
+Synapse in DEBUG mode. You could switch from the default INFO log messages to
+DEBUG log messages by changing the line
+"log4j.category.org.apache.synapse=INFO" as
+"log4j.category.org.apache.synapse=DEBUG" in the lib/log4j.properties
+file.</p>
+
<h2>Understanding the samples</h2>
<p></p>
@@ -438,6 +445,6 @@
the 'ruby' subfolder). JRuby ver 0.9.9 can be downloaded from <a
href="http://dist.codehaus.org/jruby/jruby-bin-0.9.9.tar.gz">here</a>.</p>
-<p> </p>
+<p></p>
</body>
</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: synapse-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: synapse-dev-help@ws.apache.org