You are viewing a plain text version of this content. The canonical link for it is here.
Posted to savan-dev@ws.apache.org by da...@apache.org on 2009/03/07 10:32:45 UTC
svn commit: r751230 - in /webservices/savan/trunk/c/xdocs:
docs/installationguide.html index.html
Author: damitha
Date: Sat Mar 7 09:32:45 2009
New Revision: 751230
URL: http://svn.apache.org/viewvc?rev=751230&view=rev
Log:
Updating the documentation.
Modified:
webservices/savan/trunk/c/xdocs/docs/installationguide.html
webservices/savan/trunk/c/xdocs/index.html
Modified: webservices/savan/trunk/c/xdocs/docs/installationguide.html
URL: http://svn.apache.org/viewvc/webservices/savan/trunk/c/xdocs/docs/installationguide.html?rev=751230&r1=751229&r2=751230&view=diff
==============================================================================
--- webservices/savan/trunk/c/xdocs/docs/installationguide.html (original)
+++ webservices/savan/trunk/c/xdocs/docs/installationguide.html Sat Mar 7 09:32:45 2009
@@ -1,77 +1,75 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
- "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<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>Installation Guide</title>
</head>
<body>
<h1>Apache Savan/C Installation Guide</h1>
-<p>This document guides you on how to install Savan/C with Axis2/C, and
-run the server and client samples on Linux and Microsoft Windows operating
+<p>This document guides you on how to install Savan/C with Axis2/C, and run
+the server and client samples on Linux and Microsoft Windows operating
systems.</p>
-<p>This release comes in two forms, source and binary. This document covers
-both forms.</p>
+<p>This release comes in source form. This document explain how to install
+the source.</p>
<p>Please send your feedback to the developer mailing list: <a
href="mailto:axis-c-dev@ws.apache.org">axis-c-dev@ws.apache.org</a>
(Subscription details are available on the <a
-href="http://ws.apache.org/sandesha/savan/c">Savan site</a>.) Please
-remember to prefix the subject with [Axis2].</p>
+href="http://ws.apache.org/sandesha/savan/c">Savan site</a>.) Please remember
+to prefix the subject with [Savan/C].</p>
<h2>Contents</h2>
<ul>
- <li><a href="#linux">Installing and Running on Linux</a>
+ <li><a href="#linux">Installing and Running on Linux</a>
<ul>
<li><a href="#linux_source">Using the Source Release</a></li>
<li><a href="#linux_binary">Using the Binary Release</a></li>
</ul>
</li>
- <li><a href="#win">Installing and Running on Microsoft Windows (win32)</a>
+ <li><a href="#win">Installing and Running on Microsoft Windows (win32)</a>
<ul>
<li><a href="#win_source">Using the Source Release</a></li>
<li><a href="#win_binary">Using the Binary Release</a></li>
</ul>
</li>
</ul>
-<a id="linux"></a>
+<a id="linux"></a>
<h2>1. Installing and Running on Linux</h2>
-<p>This can be done using binary or source distributions. (<a
-href="http://ws.apache.org/savan/c/download.cgi">Download</a> the two
-distributions)</p>
-
-<a id="linux_source"></a>
+<p><a href="http://ws.apache.org/savan/c/download.cgi">Download</a> source
+distribution</p>
+<a id="linux_source"></a>
<h3>1.1. Installing Savan/C Source Release on Linux</h3>
-<p>This version of Savan/C depends on Axis2/C 1.1. <a href="http://ws.apache.org/axis2/c/download.cgi">Download Axis2/C</a> from and
-install. /p>
+<p>This version of Savan/C depends on Axis2/C 1.6. <a
+href="http://ws.apache.org/axis2/c/download.cgi">Download Axis2/C</a> from
+and install. /p> </p>
<ol>
- <li> Download Savan source distribution</li>
- <li> Extract the source distribution and go to extracted directory</li>
- <li> Run configure with AXIS2 include path.
- <pre>./configure --prefix=<axis2c_deploy_path> --enable-static=no --with-axis2=<axis2c_deploy_path> --enable-filtering=no/yes</pre>
- </li>
- <li>Run make and make install</li>
+ <li>Download Savan source distribution</li>
+ <li>Extract the source distribution and go to extracted directory</li>
+ <li>Run configure with AXIS2/C include path.
+ <pre>./configure --prefix=<axis2c_deploy_path> --enable-static=no --with-axis2=<axis2c_include_file_path></pre>
+ </li>
+ <li>Run make and make install</li>
</ol>
-
-This will install the Savan/C as a module in Axis2/C in <axis2c_deploy_path>/modules folder. The module
-folder contains the Savan/C libraries and the module.xml file. It will also install libsavan_client.so savan client
-library in <axis2c_deploy_path>/lib folder. This client library is needed for savan clients to be linked with.
-
-<a id="linux_binary"></a>
+<p>Type configure --help for all available options.</p>
-<h3>1.2. Installing Savan/C Binary Release on Linux</h3>
+<p>This will install the Savan/C as a module in Axis2/C in
+<axis2c_deploy_path>/modules folder. The module folder contains the
+Savan/C libraries and the module.xml file. It will also install
+libsavan_client.so savan client library in <axis2c_deploy_path>/lib
+folder. This client library is needed for savan clients to be linked with. <a
+id="linux_binary"></a> </p>
-<p>Savan/C binary distribution for Linux has the following folder structure. </p>
+<p>Savan/C installation has the following folder structure. </p>
<pre>
Savan
|
@@ -86,38 +84,34 @@
+ - include ( header files)
+ - bin
+ - bin/samples/savan ( sample executables)
- + - lib
-</pre>
-<p>
- To deploy Savan/C in Axis2/C running environment copy the modules/savan into <axis2c_deploy_path>/modules folder.
-</p>
-<a id="win"></a>
+ + - lib </pre>
+<a id="win"></a>
<h2>2. Installing and Running on Microsoft Windows</h2>
<p>This too can be done using binary or source distributions. (<a
href="http://ws.apache.org/savan/c/download.cgi">Download</a> the two
distributions.)</p>
-
-<a id="win_source"></a>
+<a id="win_source"></a>
<h3>2.1. Installing Savan/C Source Release on Windows</h3>
<ol>
- <li> You need to have unziped Axis2/C 1.0 release binary to some folder.</li>
- <li> On your cmd.exe cd to <savan src>\build\win32 <br/>
- Edit configure.in file with your binary locations. <br/>
- </li>
- <li> To set necessary environment variables on command line run vcvars32.bat file. </li>
- <li> Run nmake dist command on command line. This will build the Savan/C binary and samples to a directory savan in <savan src>\build\savan. </li>
+ <li>You need to have unziped Axis2/C 1.0 release binary to some folder.</li>
+ <li>On your cmd.exe cd to <savan src>\build\win32 <br />
+ Edit configure.in file with your binary locations. <br />
+ </li>
+ <li>To set necessary environment variables on command line run vcvars32.bat
+ file. </li>
+ <li>Run nmake dist command on command line. This will build the Savan/C
+ binary and samples to a directory savan in <savan src>\build\savan.
+ </li>
</ol>
-
-<a id="bin_binaries"></a>
+<a id="bin_binaries"></a>
<h3>2. 2. Installing Savan/C Binary Release on Windows</h3>
<p>Savan/C binary distribution will have following directory structure. </p>
-<pre>
- Savan
+<pre> Savan
|
+ - Savan (savan module dll and module.xml file)
|
@@ -128,32 +122,28 @@
+ - source files of samples in folders
|
+ - include ( header files)
+</pre>
+<ol>
+ <li>Copy Savan directory ( containing savan dll and module.xml ) to
+ <AXIS2C_HOME>\modules directory.</li>
+ <li>Copy axis2.xml file in Savan directory to <AXIS2C_HOME> </li>
+</ol>
- </pre>
- <ol>
- <li> Copy Savan directory ( containing savan dll and module.xml ) to <AXIS2C_HOME>\modules directory.</li>
- <li> Copy axis2.xml file in Savan directory to <AXIS2C_HOME> </li>
- </ol>
- <p>
- Now you should be able to run the samples.
- </p>
+<p>Now you should be able to run the samples. </p>
<h3>Notes</h3>
<ol>
-<li>
- Savan/C has a persistent storage mechanism for storing subscriber information and data source information.
- This is implemented using Sqlite embeded database<br/>
- If you use Axis2/C Apache2 module instead of simple_axis2_server make
- sure that Apache2 user can access the sqlite database file savan_db. <br/>
-
-</li>
-<li>
- Savan/C module is installed into <axis2c_deploy_path>/modules/savanc directory. The installed module contain
- libsavan.so, module.xml. The sample clients are installed into <axis2c_deploy_path>/bin/samples/savan
- directory. Sample services are installed into <axis2c_deploy_path>/services directory.
-
-</li>
+ <li>Savan/C has pluggable storage mechanism for storing subscribers. By
+ default it runs with Sqlite embedded database.<br />
+ If you use Axis2/C Apache2 module instead of simple_axis2_server make
+ sure that Apache2 user can access the sqlite database file savan_db.
+ <p></p>
+ </li>
+ <li>Savan/C module is installed into
+ <axis2c_deploy_path>/modules/savanc directory. The installed module
+ contain libsavan.so, module.xml. The sample clients are installed into
+ <axis2c_deploy_path>/bin/samples/savan directory. Sample services
+ are installed into <axis2c_deploy_path>/services directory. </li>
</ol>
-
</body>
</html>
Modified: webservices/savan/trunk/c/xdocs/index.html
URL: http://svn.apache.org/viewvc/webservices/savan/trunk/c/xdocs/index.html?rev=751230&r1=751229&r2=751230&view=diff
==============================================================================
--- webservices/savan/trunk/c/xdocs/index.html (original)
+++ webservices/savan/trunk/c/xdocs/index.html Sat Mar 7 09:32:45 2009
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
- "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
+ "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=iso-8859-1" />
@@ -10,27 +10,51 @@
<body xml:lang="en">
<h1>Welcome to Apache Savan/C</h1>
-<p> Savan/C is a C implementation of WS-Eventing specification published by IBM, Microsoft, BEA and TIBCO. Savan/C is built on top of Axis2/C. Therefore by using Savan/C you can add ws eventing capability to the web services hosted using Axis2/C.
-Savan was designed as a general Publisher/Subscriber tool. The arcitecture was designed to abstract the general Pub/Sub features so that people could support more than one Pub/Sub mechanism within the same infrastructure. Initially support is provided for WS-Eventing. It is planned to implement some support for Atom as well.</p>
+<p>Savan/C is a C implementation of WS-Eventing specification published by
+IBM, Microsoft, BEA and TIBCO. Savan/C is built on top of Axis2/C. Therefore
+by using Savan/C you can add ws eventing capability to the web services
+hosted using Axis2/C. Savan was designed as a general Publisher/Subscriber
+tool. The arcitecture was designed to abstract the general Pub/Sub features
+so that people could support more than one Pub/Sub mechanism within the same
+infrastructure. Initially support is provided for WS-Eventing. It is planned
+to implement some support for Atom as well.</p>
<h2>Latest Release</h2>
-<p>Not released yet</p>
-<a href="download.cgi"><Link not available.></a>
+<p>Savan 1.0 will be released soon.</p>
<h4>Key Features</h4>
<ol>
- <li>Support for WS-Eventing Specification August 2004.</li>
- <li>Support for Subscribe, Unsubscribe, Renew and GetStatus operations.</li>
- <li>Support for subscription management endpoint which could be the
- Event Source itself or separate subscription management endpoint.</li>
- <li>Persistent storage for subscribers.</li>
- <li>Support for both SOAP 1.1 and 1.2.</li>
- <li>Samples to test scenarios.</li>
- <li>Documentation</li>
+ <li>Support for WS-Eventing Specification August 2004.</li>
+ <li>Support for Subscribe, Unsubscribe, Renew and GetStatus operations.</li>
+ <li>Support for subscription management endpoint which could be the Event
+ Source itself or separate subscription management endpoint.</li>
+ <li>Pluggable storage managers. Currently support three storage managers
+ namely
+ <p>- Sqlite based embedded storage manager</p>
+ <p>- Service based storage manager.</p>
+ <p>- WSO2 registry based storage manager.</p>
+ </li>
+ <li>Pluggable filtering support for server side. XPath content based
+ filtering is implemented</li>
+ <li>Interoperability with Apache Savan/Java implementation.</li>
+ <li>Interoperablity with WSO2 ESB/Eventing stack.</li>
+ <li>Support for both SOAP 1.1 and 1.2.</li>
+ <li>Comprehensive sample to test scenarios.</li>
+ <li>Documentation</li>
</ol>
-<h4>Major Changes Since Last Release</h4>
- <p>Apache Savan/C is yet to be released. </p>
+<h4>Major Changes Since <a
+href="http://ws.apache.org/savan/c/download.cgi">Savan 0.90</a> Release</h4>
+
+<ol>
+ <li>Pluggable storage managers.</li>
+ <li>Interoperability with Apache Savan/Java implementation.</li>
+ <li>Interoperablity with WSO2 ESB/Eventing stack.</li>
+ <li>Improved sample.</li>
+ <li>Many bug fixes</li>
+ <li>Improved Documentation</li>
+
+<p>Apache Savan/C 1.0 is yet to be released. </p>
</body>
</html>