This document guides you on how to install Sandesha2/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 Sandesha2 site.) Please remember to prefix the subject with [Axis2].
This can be done using binary or source distributions. (Download the two distributions)
This version of Sandesha2/C depends on Axis2/C 1.3.0 Download Axis2/C from and install.
./configure --prefix=<axis2c_deploy_path> --enable-static=no --with-axis2=<axis2c_deploy_path>
To install the samples go into samples folder and do
./configure --prefix=<axis2c_deploy_path> --with-axis2=<axis2c_include_path>
make
make install
Sandesha2/C binary distribution for Linux has the following folder structure.
Sandesha2 | + - modules/sandesha2 (sandesha2 module library and module.xml file) + - docs + - config (Contain sample module.xml and axis2.xml files) | + - samples | + - source files of samples in folders + - services (Contain sample service) | + - include ( header files) + - bin/samples ( sample executables) + - lib (libsandesha2_client.so)
To deploy Sandesha2/C in Axis2/C running environment copy the modules/sandesha2 into <axis2c_deploy_path>/modules folder. Also copy the libsandesha2_client.so into <axis2c_deploy_path>/lib folder. Do the necessary changes to the <axis2c_deploy_path>/axis2.xml to run Sandesha2/C(Refer to the sample config/axis2.xml for help). To run samples copy the server sample services/RMSampleService into <axis2c_deploy_path>/services folder and start the server. Then you can run the client samples in bin/samples/sandesha2. To see the messages passing through the wire use a Tcp Monitor.
This too can be done using binary or source distributions. (Download the two distributions.)
Sandesha2/C binary distribution will have following directory structure.
Sandesha2 | + - Sandesha2 (sandesha2 module dll and module.xml file) | + - samples | + - bin | + - source files of samples in folders | + - include ( header files) + - lib (sandesha2_client.dll)
Now you should be able to run the samples.
module.xml file as following.
<parameter name="sandesha2_db" locked="false"><path>/sandesha2_db</parameter>
If you use Axis2/C Apache2 module instead of simple_axis2_server make sure that Apache2 user can access the above database file.
If you do not provide the above database parameter, be aware that Sandesha2/C will create the database file named sandesha2_db in the current folder.