| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Apache Savan/C - The WS-Eventing Module for Apache Axis2/C</title><style type="text/css" media="all"> |
| @import url("../style/maven-base.css"); |
| |
| @import url("../style/maven-classic.css");</style><link rel="stylesheet" href="../style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://www.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src="http://www.apache.org/images/asf-logo.gif"></img></a><a href="http://ws.apache.org/savan/c" id="projectLogo"><img alt="Apache Savan/C" src="http://ws.apache.org/savan/c/images/savanc_logo.jpg"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft"> |
| Last published: 28 May 2007 |
| </div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuApache_Savan_C"><h5>Apache Savan/C</h5><ul><li class="none"><a href="../index.html">Apache Savan/C Home</a></li><li class="expanded"><a href="../download.cgi">Download Savan/C</a><ul><li class="none"><a href="../download.cgi">Releases</a></li></ul></li><li class="expanded"><a href="../docs/index.html">Documentation</a><ul><li class="none"><a href="../docs/installationguide.html">Installation Guide</a></li><li class="none"><a href="../docs/savanc_manual.html">Savan/C manual</a></li></ul></li><li class="expanded"><a href="../lists_issues.html">Get Involved</a><ul><li class="none"><a href="../lists_issues.html">Mailing Lists & Issue Tracking</a></li><li class="none"><a href="../svn.html">Checkout Source Code</a></li></ul></li><li class="expanded"><a href="../coding_conventions.html">Developer Guidelines</a><ul><li class="none"><a href="../coding_conventions.html">Coding Convention</a></li><li class="none"><a href="../versioning.html">Versionning</a></li></ul></li><li class="expanded"><a href="../team-list.html">Project Information</a><ul><li class="none"><a href="../team-list.html">Project Team</a></li><li class="none"><a href="http://svn.apache.org/repos/asf/webservices/sandesha/trunk/c" class="externalLink" title="External Link">Source Code</a></li></ul></li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="../images/logos/maven-button-1.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Apache_Savan_C_Installation_Guide"></a><h2>Apache Savan/C Installation Guide</h2><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 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 [Savan/C].</p> |
| |
| <h2>Contents</h2> |
| <ul> |
| <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> |
| <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> |
| |
| <h2>1. Installing and Running on Linux</h2> |
| |
| <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.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/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> |
| |
| <p>Type configure --help for all available options.</p> |
| |
| <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 installation has the following folder structure. </p> |
| <pre> |
| Savan |
| | |
| + - modules/savan (savan module library and module.xml file) |
| + - docs |
| | |
| + - samples |
| | |
| + - source files of samples in folders |
| + - services (Contain Subscription Manager service and sample data source services) |
| | |
| + - include ( header files) |
| + - bin |
| + - bin/samples/savan ( sample executables) |
| + - 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> |
| |
| <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> |
| </ol> |
| <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 |
| | |
| + - Savan (savan module dll and module.xml file) |
| | |
| + - samples |
| | |
| + - bin |
| | |
| + - 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> |
| |
| <p>Now you should be able to run the samples. </p> |
| |
| <h3>Notes</h3> |
| <ol> |
| <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> |
| </div></div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2005-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html> |
