INSTALL

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_deploy_path> --enable-static=no --with-axis2=<axis2c_deploy_path>//include/axis2-1.1 --enable-filtering=no/yes
    make
    make install
    
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.


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 copy the modules/savan into <axis2c_deploy_path>/modules folder.

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)

    Copy Savan directory ( containing savan dll and module.xml ) to <AXIS2C_HOME>\modules directory.
    Copy axis2.xml file in Savan directory to <AXIS2C_HOME> 
    
    Now you should be able to run the samples.

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_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.