| 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. |
| |
| This release comes in two forms, source and binary. This document covers |
| both forms. |
| |
| Please send your feedback to the developer mailing list: |
| |
| axis-c-dev@ws.apache.org |
| |
| (Subscription details are available on the http://ws.apache.org/sandesha/savan/c.) Please |
| remember to prefix the subject with [Axis2]. |
| |
| 1. Installing and Running on Linux |
| |
| This can be done using binary or source distributions. |
| |
| http://ws.apache.org/savan/c/download.cgi |
| |
| 1.1. Installing Savan/C Source Release on Linux |
| |
| This version of Savan/C depends on Axis2/C 1.1. Download from |
| |
| http://ws.apache.org/axis2/c/download.cgi |
| |
| and install. |
| Download Savan source distribution |
| Extract the source distribution and go to extracted directory |
| Run configure with AXIS2 include path. |
| ./configure --prefix=<AXIS2C_HOME> --enable-static=no --with-axis2=<AXIS2C_HOME>/include/axis2-<version> --enable-filtering=no/yes |
| make |
| make install |
| |
| This will install the Savan/C as a module in Axis2/C in <AXIS2C_HOME>/modules folder. The module |
| folder contains the Savan/C libraries and the module.xml file. In the module.xml file give a valid path |
| for database storage. The database name should be savan_db. |
| <parameter name="savan_db" locked="false">/tmp/savan_db</parameter> |
| It will also install libsavan_client.so savan client |
| library in <AXIS2C_HOME>/lib folder. This client library is needed for savan clients to be linked with. |
| To test the installation you can run the subscriber sample by running |
| <AXIS2C_HOME/bin/samples/savan/subscriber |
| |
| |
| 1.2. Installing Savan/C Binary Release on Linux |
| |
| Savan/C binary distribution for Linux has the following folder structure. |
| 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 |
| To deploy Savan/C in Axis2/C running environment do the following |
| 1. Copy the modules/savan into <AXIS2C_HOME>/modules folder. |
| 2 In the module.xml file give a valid path for database storage. savan_db should be the database name. |
| <parameter name="savan_db" locked="false">/tmp/savan_db</parameter> |
| 3. Copy the libsavan_client.so into <AXIS2C_HOME>/lib folder. This client library is needed for savan clients |
| to be linked with. |
| 4. Copy the samples/server/axis2.xml into <AXIS2C_HOME> or do neccessary changes as described in README |
| document to existing axis2.xml in repository. |
| 5. Copy the services/subscription service into <AXIS2C_HOME>/serivces folder. |
| 6. If you need deploy server samples copy services/pubisher and services/listener service into |
| <AXIS2C_HOME>/serivces folder. |
| 7. Now you can run the client subscriber sample from bin/samples/savan |
| |
| 2. Installing and Running on Microsoft Windows |
| |
| This too can be done using binary or source distributions. |
| |
| http://ws.apache.org/savan/c/download.cgi |
| |
| |
| 2.1. Installing Savan/C Source Release on Windows |
| You need to have unziped Axis2/C 1.1.0 release binary to some folder. |
| On your cmd.exe cd to <savan src>\build\win32 |
| Edit configure.in file with your binary locations. |
| |
| To set necessary environment variables on command line run vcvars32.bat file. |
| 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. |
| |
| |
| 2. 2. Installing Savan/C Binary Release on Windows |
| |
| Savan/C binary distribution will have following directory structure. |
| Savan |
| | |
| + - Savan (savan module dll and module.xml file) |
| | |
| + - samples |
| | |
| + - bin |
| | |
| + - source files of samples in folders |
| | |
| + - include ( header files) |
| |
| 1 Copy Savan directory ( containing savan dll and module.xml ) to <AXIS2C_HOME>\modules directory. |
| 2 In the module.xml file give a valid path for database storage. savan_db should be the database name. |
| <parameter name="savan_db" locked="false">/tmp/savan_db</parameter> |
| 3. Copy the savan_client.dll into <AXIS2C_HOME>/lib folder. This client library is needed for savan clients |
| to be linked with. |
| 4. Copy the samples/server/axis2.xml into <AXIS2C_HOME> or do neccessary changes as described in README |
| document to existing axis2.xml in repository. |
| 5. Copy the services/subscription service into <AXIS2C_HOME>/serivces folder. |
| 6. If you need deploy server samples copy services/pubisher and services/listener service into |
| <AXIS2C_HOME>/serivces folder. |
| 7. Now you can run the client subscriber sample from bin/samples/savan |
| |
| |
| Notes: |
| Savan/C has a persistent storage mechanism for storing subscriber information and data source information. |
| This is implemented using Sqlite embedded database |
| If you use Axis2/C Apache2 module instead of simple_axis2_server make |
| sure that Apache2 user have full access to the sqlite database file savan_db. |
| |
| Savan/C module is installed into <AXIS2C_HOME>/modules/savanc directory. The installed module contain |
| libsavan.so, module.xml. The sample clients are installed into <AXIS2C_HOME>/bin/samples/savan |
| directory. Sample services are installed into <AXIS2C_HOME>/services directory. |
| |