Author: samisa
Date: Tue Jun 19 00:50:57 2007
New Revision: 548634
URL: http://svn.apache.org/viewvc?view=rev&rev=548634
Log:
Added manual and fixed navigation
Added:
webservices/sandesha/trunk/c/xdocs/docs/sandesha2_manual.html
Modified:
webservices/sandesha/trunk/c/xdocs/navigation.xml
Added: webservices/sandesha/trunk/c/xdocs/docs/sandesha2_manual.html
URL:
http://svn.apache.org/viewvc/webservices/sandesha/trunk/c/xdocs/docs/sandesha2_manual.html?view=auto&rev=548634
==============================================================================
--- webservices/sandesha/trunk/c/xdocs/docs/sandesha2_manual.html (added)
+++ webservices/sandesha/trunk/c/xdocs/docs/sandesha2_manual.html Tue Jun 19
00:50:57 2007
@@ -0,0 +1,122 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+ "DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml";>
+<head>
+ <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
+ <title>README</title>
+</head>
+
+<body>
+<h1>Engaging Sandesha2/C Module</h1>
+<p>
+ Install sandesha2 module into <axis2 deploy folder>/modules folder.
Add the RMPhase
+ information into axis2.xml as following. Search for 'RMPhase' in the
+ following xml block to identify the RM specific entries.
+</p>
+<pre>
+ <!-- ================================================= -->
+ <!-- Phases -->
+ <!-- ================================================= -->
+ <phaseOrder type="inflow">
+ <!-- System pre defined phases -->
+ <phase name="TransportIn"/>
+ <phase name="PreDispatch"/>
+ <phase name="Dispatch">
+ <handler name="AddressingBasedDispatcher"
+ class="axis2_engine">
+ <order phase="Dispatch"/>
+ </handler>
+ <handler name="RequestURIBasedDispatcher"
+ class="axis2_engine">
+ <order phase="Dispatch"/>
+ </handler>
+ <handler name="SOAPActionBasedDispatcher"
+ class="axis2_engine">
+ <order phase="Dispatch"/>
+ </handler>
+ <handler name="SOAPMessageBodyBasedDispatcher"
+ class="axis2_engine">
+ <order phase="Dispatch"/>
+ </handler>
+ </phase>
+ <phase name="PostDispatch">
+ <handler name="DispatchPostConditionsEvaluator"
+ class="axis2_engine">
+ <order phase="PostDispatch"/>
+ </handler>
+ <handler name="InstanceDispatcher"
+ class="axis2_engine">
+ <order phase="PostDispatch"/>
+ </handler>
+ <handler name="SOAPProcessingModelChecker"
+ class="axis2_engine">
+ <order phase="PostDispatch"/>
+ </handler>
+ </phase>
+ <!-- System pre defined phases -->
+ <!-- After Postdispatch phase module author or or service author
can add any phase he want -->
+ <!--phase name="userphase1"/-->
+ <phase name="RMPhase"/>
+ </phaseOrder>
+ <phaseOrder type="outflow">
+ <!-- user can add his own phases to this area -->
+ <phase name="RMPhase"/>
+ <!--phase name="userphase1"/-->
+ <!--system predefined phase-->
+ <!--these phase will run irrespective of the service-->
+ <!--phase name="PolicyDetermination"/-->
+ <!--phase name="MessageOut"/-->
+ </phaseOrder>
+ <phaseOrder type="INfaultflow">
+ <!-- user can add his own phases to this area -->
+ <!--phase name="userphase1"/-->
+ <phase name="RMPhase"/>
+ </phaseOrder>
+ <phaseOrder type="Outfaultflow">
+ <!-- user can add his own phases to this area -->
+ <phase name="RMPhase"/>
+ <phase name="MessageOut"/>
+ <!--phase name="userphase1"/-->
+ <!--phase name="PolicyDetermination"/-->
+ </phaseOrder>
+</pre>
+<p>
+In the services xml file for the service which require RM enabled
+add the entry
+ <module ref="sandesha2"/>
+If you need all services in the engine RM enabled add the above entry into
+axis2.xml.
+</p>
+<p>
+You can use samples in the samples folder for testing.
+</p>
+
+<h2>Known Issues</h2>
+
+Please keep in mind the following when using Sandesha2/C with Axis2/C.
+<ol>
+<li>Comment the line no:295 in
src/core/transport/http/receiver/http_svr_thread.c
+ <pre>axutil_free_thread_env(thread_env);</pre>
+</li>
+
+<li>Comment the line no:299 in
src/core/transport/http/receiver/http_svr_thread.c
+ <pre>axutil_thread_pool_exit_thread(env->thread_pool, thd);</pre>
+</li>
+<li>Comment the following block starting form line no:259
src/core/transport/http/sender/http_sender.c
+<pre>
+ property = axutil_property_create(env);
+ axutil_property_set_scope(property, env, AXIS2_SCOPE_REQUEST);
+ axutil_property_set_free_func(property, env,
axis2_http_client_free_void_arg);
+ axutil_property_set_value(property, env, sender->client);
+ axis2_msg_ctx_set_property(msg_ctx, env, AXIS2_HTTP_CLIENT, property);
+</pre>
+</li>
+<li>If for some reason RM sequences seems not executing properly the reason
could
+ be the database is corrupted for some reason. Try rerunning the the
database
+ scripts to clean the database.
+</li>
+</ol>
+Some of the above changes may lead to memory leaks in Axis2/C.
+</body>
+</html>
Modified: webservices/sandesha/trunk/c/xdocs/navigation.xml
URL:
http://svn.apache.org/viewvc/webservices/sandesha/trunk/c/xdocs/navigation.xml?view=diff&rev=548634&r1=548633&r2=548634
==============================================================================
--- webservices/sandesha/trunk/c/xdocs/navigation.xml (original)
+++ webservices/sandesha/trunk/c/xdocs/navigation.xml Tue Jun 19 00:50:57 2007
@@ -7,7 +7,7 @@
</item>
<item name="Documentation" href="docs/index.html">
<item name="Installation Guide"
href="docs/installationguide.html"/>
- <item name="Sandesha2/C manual"
href="docs/rampartc_manual.html"/>
+ <item name="Sandesha2/C manual"
href="docs/sandesha2_manual.html"/>
</item>
<item name="Get Involved" href="lists_issues.html">
<item name="Mailing Lists & Issue Tracking"
href="lists_issues.html"/>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
