2014/09/20 - Apache Axis Savan/C has been retired.

Apache Savan/C Installation Guide

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 source form. This document explain how to install the source.

Please send your feedback to the developer mailing list: axis-c-dev@ws.apache.org (Subscription details are available on the Savan site.) Please remember to prefix the subject with [Savan/C].

Contents

• Installing and Running on Linux
  • Using the Source Release
  • Using the Binary Release
• Installing and Running on Microsoft Windows (win32)
  • Using the Source Release
  • Using the Binary Release

1. Installing and Running on Linux

Download source distribution

1.1. Installing Savan/C Source Release on Linux

This version of Savan/C depends on Axis2/C 1.6. Download Axis2/C from and install. /p>

1. Download Savan source distribution
2. Extract the source distribution and go to extracted directory
3. Run configure with AXIS2/C include path.

   ./configure --prefix=<axis2c_deploy_path> --enable-static=no --with-axis2=<axis2c_include_file_path>

4. Run make and make install

Type configure --help for all available options.

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.

Savan/C installation 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 

2. Installing and Running on Microsoft Windows

This too can be done using binary or source distributions. (Download the two distributions.)

2.1. Installing Savan/C Source Release on Windows

1. You need to have unziped Axis2/C 1.0 release binary to some folder.
2. On your cmd.exe cd to <savan src>\build\win32
   Edit configure.in file with your binary locations.
   
3. To set necessary environment variables on command line run vcvars32.bat file.
4. 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. Copy axis2.xml file in Savan directory to <AXIS2C_HOME>

Now you should be able to run the samples.

Notes

1. Savan/C has pluggable storage mechanism for storing subscribers. By default it runs with Sqlite embedded database.
   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.

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