##### Apache Savan/C

- Apache Savan/C Home
- Download Savan/C
  - Releases
- Documentation
  - Installation Guide
  - Savan/C manual
- Get Involved
  - Mailing Lists & Issue Tracking
  - Checkout Source Code
- Developer Guidelines
  - Coding Convention
  - Versionning
- Project Information
  - Project Team
  - Source Code

## 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
- Installing and Running on Microsoft Windows (win32)

## 1. Installing and Running on Linux

Download source distribution

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
            |
            + - services (Contain Subscription Manager service and sample data source services)
            |
            + - include ( header files)
            + - bin
            + - samples/bin/savan ( sample executables)
            + - lib

## 2. Installing and Running on Microsoft Windows

This too can be done using source distribution. (Download the distribution.)

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.

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 <WSFCPP_HOME>\modules directory.
2. Copy axis2.xml file in Savan directory to <WSFCPP_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.