You are viewing a plain text version of this content. The canonical link for it is here.
Posted to sandesha-dev@ws.apache.org by da...@apache.org on 2007/05/08 07:34:44 UTC
svn commit: r536059 - in /webservices/sandesha/trunk/c: INSTALL README
Author: damitha
Date: Mon May 7 22:34:44 2007
New Revision: 536059
URL: http://svn.apache.org/viewvc?view=rev&rev=536059
Log:
improving documentaion to get install and running in Linux
Modified:
webservices/sandesha/trunk/c/INSTALL
webservices/sandesha/trunk/c/README
Modified: webservices/sandesha/trunk/c/INSTALL
URL: http://svn.apache.org/viewvc/webservices/sandesha/trunk/c/INSTALL?view=diff&rev=536059&r1=536058&r2=536059
==============================================================================
--- webservices/sandesha/trunk/c/INSTALL (original)
+++ webservices/sandesha/trunk/c/INSTALL Mon May 7 22:34:44 2007
@@ -1,44 +1,41 @@
SANDESHA2 INSTALL
=================
-1. Getting Sandesha2C working with the source release on Linux
+1. Installing Sandesha2C source release on Linux
+
- This version of Sandesha2C depends on Axis2C 1.0
- Download Axis2C from http://ws.apache.org/axis2/c/download.cgi and
install.
- Go to Sandesha2C source directory
- Run configure with AXIS2 include path.
- ./configure --prefix=<axis2c_install_path> --enable-static=no --with-axis2=<axis2c_install_path>
+ ./configure --prefix=<axis2c_deploy_path> --enable-static=no --with-axis2=<axis2c_deploy_path>
- Run make and make install
-
-Note: 1.
- Sandesha2 has two main storage mechanisms call inmemory and persistent. The persistent storage could use
- either sqlite or mysql as it's database manager.
- By default sandesha2 use the persistent storage with sqlite as the database.
- It is assumed that sqlite3.h in /usr/include include directory. If you have different include path for
- sqlite3.h then add the configure option --with-sqlite=<sqlite include file path> to the configure options
- above. If is assumed that libsqlite3.so is in the /usr/lib folder
- To run samples in persistent/sqlite mode copy sandesha2c/config/sqlite_schema.sh to axis2c deploy directory and
- execute it to create the database schema. sqlite3 is an embedded database which need no configuration. If you
- use axis2c apache2 module instead of simple_axis2_server make sure that apache2 user can access the sqlite
- database files sandesha2_svr_db and sandesha2_client_db.
- if you want to use the inmemory storage instead, change the entry in the sandesha2_constants.h
- file.
- #define SANDESHA2_DEFAULT_STORAGE_MGR "persistent" as
- #define SANDESHA2_DEFAULT_STORAGE_MGR "inmemory".
+ This will install the sandesha2c as a module in axis2c in <axis2c_deploy_path>/modules folder. The module
+ folder contains the sandesha2c libraries and the module.xml file.
- If you want to use persistent storage with mysql then add the option --with-mysql=<mysql include file path>
- to the configure options above. It is assumed that libmysqlclient.so is in /usr/lib folder. It is recommended
- to use mysql database for serius use. It is not included as as the default database because of licencing issues.
- To run samples in persistent/mysql mode copy sandesha2c/config/mysql_schema.sh and sandesha2c/config/init_mysql.sh
- to axis2c deploy directory and execute it to create the database schema. The database parameters for mysql should
- be included in module.xml. The defaults for server, user and password are localhost, g,g.
+2. Installing Sandesha2C binary release on Linux
+ Sandesha2c 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
+ |
+ + - include ( header files)
+ + - bin (database scripts)
+ + - bin/samples ( sample executables)
- 2.
- Sandesha2 module is installed into <axis2c_install_path>/modules/sandesha2c directory. The installed module contain
- libsandesha2.so, module.xml and header files. The sample clients are installed into <axis2c_install_path>/bin/samples
- directory. Sample services are installed into <axis2c_install_path>/services directory.
+ To deploy sandesha2c in axis2c running environment copy the modules/sandesha2 into <axis2c_deploy_path>/modules folder.
+ Do the neccessary changes to the <axis2c_deploy_path>/axis2.xml to run sandesha2c(Refer to the sample config/axis2.xml
+ for help).
-2 Installing Sandesha2c on WIN32
+
+3 Installing Sandesha2c on WIN32
1. Building from source distribution
@@ -78,7 +75,36 @@
Now you should be able to run the samples.
-
+ Note: 1.
+ Sandesha2 has two main storage mechanisms call inmemory and persistent. The persistent storage could use
+ either sqlite or mysql as it's database manager.
+ By default sandesha2 use the persistent storage with sqlite as the database.
+ It is assumed that sqlite3.h in /usr/include include directory. If you have different include path for
+ sqlite3.h then add the configure option --with-sqlite=<sqlite include file path> to the configure options
+ above. If is assumed that libsqlite3.so is in the /usr/lib folder
+ To run samples in persistent/sqlite mode copy sandesha2c/config/sqlite_schema.sh/.bat to a directory where you
+ will create your sqlite database file and execute it to create the database schema. sqlite3 is an embedded
+ database which need no configuration. If you use axis2c apache2 module instead of simple_axis2_server make
+ sure that apache2 user can access the sqlite database files sandesha2_svr_db and sandesha2_client_db.
+
+ if you want to use the inmemory storage instead, change the entry in the sandesha2_constants.h
+ file.
+ #define SANDESHA2_DEFAULT_STORAGE_MGR "persistent" as
+ #define SANDESHA2_DEFAULT_STORAGE_MGR "inmemory".
+
+ If you want to use persistent storage with mysql then add the option --with-mysql=<mysql include file path>
+ to the configure options above. It is assumed that libmysqlclient.so is in /usr/lib folder. It is recommended
+ to use mysql database for any erious use. It is not included as as the default database because of licencing issues.
+ To run samples in persistent/mysql mode run sandesha2c/config/mysql_schema.sh and sandesha2c/config/init_mysql.sh
+ to create the database schema. The database parameters for mysql should
+ be included in module.xml. The defaults for server, user and password are localhost, g,g.
+
+ 2.
+ Sandesha2 module is installed into <axis2c_deploy_path>/modules/sandesha2c directory. The installed module contain
+ libsandesha2.so, module.xml. The sample clients are installed into <axis2c_deploy_path>/bin/samples
+ directory. Sample services are installed into <axis2c_deploy_path>/services directory.
+
+
Modified: webservices/sandesha/trunk/c/README
URL: http://svn.apache.org/viewvc/webservices/sandesha/trunk/c/README?view=diff&rev=536059&r1=536058&r2=536059
==============================================================================
--- webservices/sandesha/trunk/c/README (original)
+++ webservices/sandesha/trunk/c/README Mon May 7 22:34:44 2007
@@ -12,7 +12,7 @@
The Latest Version
------------------
- Sandesha2C is its early ages and not release yet.
+ 0.90.
Documentation
-------------
@@ -27,15 +27,15 @@
Installation
------------
- Please see the file called INSTALL.
+ Please see the INSTALL file.
Licensing
---------
- Please see the file called LICENSE.
+ Please see the LICENSE file.
How To Run.
----------
- Install sandesha2 module into axis2/modules folder. Add the RMPhase
+ Install sandesha2 module into <axis2 deploy folder>/modules folder. Add the RMPhase
information into axis2.xml as following. Search for 'RMPhase' in the
following xml block to identify the RM specific entries.
@@ -113,13 +113,3 @@
You can use samples in the samples folder for testing.
-Note: Sandesha2 has two main storage mechanisms call inmemory and persistent.
- By default sandesha2 use the sqlite as the persistent storage. You can
- change this to inmemory by changing the entry in the sandesha2_constants.h
- file.
- #define SANDESHA2_DEFAULT_STORAGE_MGR "persistent"
-
- You must have sqlite3.h in sandesha2 include directory.
- When compiling it statically link with sqlite library. So make sure you have
- src/core/libsqlite3.a.
- Above configurations regarding sqlite may be refined before the release.
---------------------------------------------------------------------
To unsubscribe, e-mail: sandesha-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: sandesha-dev-help@ws.apache.org