svn commit: r1049438 - /synapse/branches/2.0/src/site/xdoc/upgrading.xml

[ru...@apache.org]

Author: ruwan
Date: Wed Dec 15 06:26:08 2010
New Revision: 1049438

URL: http://svn.apache.org/viewvc?rev=1049438&view=rev
Log:
updating the upgrade guide to have the synapse.xml location move with a generic description of the repository based configuration

Modified:
    synapse/branches/2.0/src/site/xdoc/upgrading.xml

Modified: synapse/branches/2.0/src/site/xdoc/upgrading.xml
URL: http://svn.apache.org/viewvc/synapse/branches/2.0/src/site/xdoc/upgrading.xml?rev=1049438&r1=1049437&r2=1049438&view=diff
==============================================================================
--- synapse/branches/2.0/src/site/xdoc/upgrading.xml (original)
+++ synapse/branches/2.0/src/site/xdoc/upgrading.xml Wed Dec 15 06:26:08 2010
@@ -47,6 +47,37 @@
             easier.</p>
         </section>
         <section name="Upgrading from 1.2 to 2.0.0">
+          <subsection name="Configuration file vs multi XML configuration">
+            <p>In 1.2 you have been using a single synapse.xml file which resides on the repository/conf directory of
+            the distribution, where as on 2.0.0 we have structured this into a configuration repository with
+            multiple directories to have different artifact types and each and every artifact configuration
+            to reside on a different files inside the desired repository directory. This repository directory on the 2.0.0
+            release resides in the repository/conf directory too, and named as synapse-config.
+            The repository directory structure inside the synapse-config directory looks like follows;</p>
+<pre>synapse-config
+    /endpoints
+    /event-sources
+    /local-entries
+    /priority-executors
+    /proxy-services
+    /sequences
+        main.xml
+        fault.xml
+    /tasks
+    registry.xml
+    synapse.xml
+</pre>
+            <p>As you can see in the above sketch of the repository though it is a repository based
+            configuration, it also supports the old style single flat synapse.xml file in which case
+            it has to reside inside the root of the repository.</p>
+            <p>So the easiest way to migrate the configuration is to move your
+            already existing synapse.xml file in repository/conf directory in 1.2 version into the
+            repository/conf/synapse-config directory of the 2.0.0 version. <em>Note: When doing this
+            migration you should also delete the main.xml and fault.xml files which are there on the
+            sequences directory of the repository, otherwise there will be 2 main and fault
+            sequences one coming from the sequences directory and the other coming from your just
+            copied synapse.xml file</em></p>
+          </subsection>
           <subsection name="Endpoint URLs for proxy services">
             <p>In release 2.0.0 the endpoint URLs for proxy services have changed from <tt>/soap</tt>
             to <tt>/services</tt>. E.g. <tt>http://localhost:8280/services/StockQuote</tt> should be