apache-tuscany/sca-cpp/trunk/INSTALL

Apache Tuscany SCA Runtime
==========================

Building
========

The Tuscany SCA Linux build uses the GNU Autotools tool chain.

First install the following development tools:
autoconf-2.64
automake-1.4
g++-4.4.1
libtool-2.2.6
doxygen-1.6.1

Install the following binaries:
curl-7.19.5
memcached-1.2.8


Then install the following development dependencies:

HTTP server and APR
httpd-2.2-13
libapr-1-0.3.8
libaprutil-1-0.3.9

Recommended HTTPD configure options:
--with-included-apr to build HTTPD with the included APR distribution,
--with-mpm=worker to run HTTPD modules in multiple threads.

XML
libxml2-2.7.5

CURL
libcurl4-7.19.5

JSON
SpiderMonkey libmozjs
(included in xulrunner-1.9.1.5)

Python
libpython2.6


To configure the Tuscany SCA build do this:
./autogen.sh
./configure --prefix=<install dir>

To enable debugging and strict warning compile options, add:
--enable-maintainer-mode

To enable gprof profiling, add:
--enable-profiling

To enable multi-threading with the HTTPD worker MPM, add:
--enable-threads

To enable support for Python component implementations:
--enable-python

To enable support for Java component implementations:
--enable-java

To build the Web service utility component (using Axis2C):
--enable-webservice

To generate doxygen documentation, add:
--enable-doxygen

To configure where to find dependencies, see the --with-* options described
in the configure help:
./configure --help


Here's an example configuration, tested on Ubuntu 9.10, with development
dependencies installed in the standard directories and a build of the
HTTPD worker MPM in $HOME/httpd-2-2.13-bin:

./configure --prefix=$HOME/tuscany-sca-cpp-bin \
--with-apr=$HOME/httpd-2.2.13-bin --with-httpd=$HOME/httpd-2.2.13-bin \
--with-curl=/usr --with-libxml2=/usr \
--with-js-include=/usr/include/xulrunner-1.9.1.5/unstable \
--with-js-lib=/usr/lib/xulrunner-1.9.1.5 \
--enable-python --with-python=/usr \
--enable-java --with-java=/usr/lib/jvm/default-java \
--enable-webservice --with-axis2c=$HOME/axis2c-1.6.0-bin \
--enable-threads --enable-maintainer-mode


To build the Tuscany SCA runtime, do this:
make

To run the tests, do this:
make check

To build ctags for the source, do this:
make ctags

To build a source distribution, do this:
make dist

To build a binary distribution, do this:
make bindist


Installing
==========

To install the Tuscany SCA binaries, do this:
make install