Page History

The main Tuscany project repository is located at

https://svn.apache.org/repos/asf/incubator/tuscany.

You

can

use

SVN

to

check

out

the

entire

project,

and

you

will

get

both

the

java

and

C++

repositories.

Alternatively

you

can

check

out

just

the

cpp

directory

at

https://svn.apache.org/repos/asf/incubator/tuscany/cpp,

to

get

the

SCA

and

SDO

implementations

for

C++.

• From

• $HOME/tuscany,

• do

• svn

• co

• http://svn.apache.org/repos/asf/incubator/tuscany/cpp,

• this

• will

• check

• out

• all

• the

• source

• code

• in

• $HOME/tuscany/cpp.

• Configure

• your

• environment:

• • export

• • TUSCANY_SCACPP=$HOME/tuscany/cpp/sca/deploy

• • export

• • TUSCANY_SDOCPP=$HOME/tuscany/cpp/sdo/deploy

• • export

• • LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$TUSCANY_SDOCPP/lib:$TUSCANY_SCACPP/lib

Below you can find detailed instructions on how to configure the C++ runtime and tools for Linux or Windows.

Anchor
Setup Linux Setup Linux

Linux

These steps take no more than 15 mns to complete,starting from scratch. After you complete them, you should be all set to build the Tuscany C++ runtime.

From a shell prompt, create a $HOME/tuscany directory.

Prerequisites

Install the following prerequisites:

1. Subversion - SVN version 1.3.0 or later is good (most Linux distros already include SVN).
2. Ant and a Java JDK are required by the SCA code generation tool used to generate proxies and wrappers for C++ components.
   • Download apache-ant-1.6.5-bin

1. • to

1. • '$HOME/tuscany'

1. • do

1. • tar

1. • xzf

1. • apache-ant-1.6.5-bin.tar.gz.

1. • Configure your environment:
     • export JAVA_HOME=$HOME/tuscany/jdk1.5.0_06

1. • • PATH=$JAVA_HOME/bin:$PATH

1. • Download JDK 5.0

1. • from

1. • java.sun.com.

1. • From $HOME/tuscany

1. • run

1. • jdk-1_5_0_06-linux-i586.bin,

1. • this

1. • will

1. • extract

1. • the

1. • JDK

1. • in

1. • $HOME/tuscany/jdk1.5.0_06.

1. • Configure your environment:
     • export JAVA_HOME=$HOME/tuscany/jdk1.5.0_06

1. • • PATH=$JAVA_HOME/bin:$PATH

2. Libxml2

1. 2.6.20

1. or

1. later.Libxml2

1. is

1. already

1. in

1. most

1. Linux

1. distros,

1. just

1. check

1. that

1. you

1. have

1. version

1. 2.6.20

1. or

1. later.

1. To

1. see

1. which

1. version

1. of

1. libxml2

1. is

1. installed

1. on

1. your

1. system

1. do

1. rpm

1. -aq

1. |

1. grep

1. libxml2.

1. • Configure your environment:
     • export LIBXML2_LIB=/usr/lib

1. • • export LIBXML2_INCLUDE=/usr/include/libxml2

2. Axis2C

1. version

1. 0.92.

1. • Download axis2c-bin-0.92-linux.tar.gz

1. • from

1. • Apache.org.

1. • From $HOME/Tuscany

1. • do

1. • tar

1. • xzf

1. • axis2c-bin-0.92-linux.tar.gz,

1. • this

1. • will

1. • install

1. • Axis2C

1. • in

1. • $HOME/Tuscany/axis2c-bin-0.92-linux.

1. • Configure your environment:
     • export AXIS2C_HOME=$HOME/tuscany/axis2c-bin-0.92-linux

1. • • export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$AXIS2C_HOME/lib

Anchor
Setup Windows Setup Windows

Windows

These steps take no more than 15 mns to complete,starting from scratch. After you complete them, you should be all set to build the Tuscany C++ runtime.

• Right click on "My Computer" and select properties. Select the advanced tab and click on Enviroment Variables. Under User Variables, click on new.
• In variable name type ANT_HOME
• In variable value insert the path to where you expanded apache ant. EG, "C:\tuscany\apache-ant-1.6.5"

• and

• hit

• ok.

• Now select the User variable PATH. Select new if it doesn't

• already

• create

• it.

• Append to the end the path to the apache-ant

• bin

• directory.

• EG,

• "C:\tuscany\apache-ant-1.6.5\bin;"

• Select ok and close the windows.

• Run the JDK installer.
• Right click on "My Computer" and select properties. Select the advanced tab and click on Enviroment Variables. Under User Variables, click on new.

• In variable name type JAVA_HOME
• In variable value insert the path to where you installed java. EG, "C:\Program Files\Java\jdk1.5.0_07"
• Select ok and close the windows.

Anchor
System Requirements System Requirements

System Requirements

In order to run the Tuscany Native runtimes there are some minimum system requirements:

Anchor
Building Building

Building the source code

The builds use the GNU automake + configure tools, which nicely analyze your environment and generate all the make files you need.

To build the SDO C++ runtime:

cd $HOME/tuscany/cpp/sdo
./autogen.sh
./configure --prefix=$TUSCANY_SDOCPP --enable-static=no
make
make install
cd $HOME/tuscany/cpp/sdo/samples
./autogen.sh
./configure --prefix=$TUSCANY_SDOCPP --enable-static=no
make
make install

Note: Tuscany already has build.sh scripts that do all of this for you, but I wanted to use the individual commands to understand what was going on at each step. Also, when you make code changes in general you just run make and make install and not the whole set of steps.

To run the the SDO test suite:

cd $HOME/tuscany/cpp/sdo
./sdotest.sh

To build the SCA C++ runtime:

cd $HOME/tuscany/cpp/sca
./autogen.sh
./configure --prefix=$TUSCANY_SCACPP --enable-static=no
make
make install
cd $HOME/tuscany/cpp/sdo/samples
./autogen.sh
./configure --prefix=$TUSCANY_SCACPP --enable-static=no
make
make install

To run the SCA runtime tests:

cd $HOME/tuscany/cpp/sdo
./scatest.sh

To run the SCA calculator sample:

cd $HOME/tuscany/cpp/sca/deploy/samples/Calculator/deploy/bin
./runclient.sh
    * Select ok and close the windows.


h3. {anchor:System Requirements} System Requirements

In order to run the Tuscany Native runtimes there are some minimum system requirements:

{table}
{tr}
{td}
Operating System
{td}
{td}
* Windows XP SP2
* Linux
{td}
{tr}
{tr}
{td}
Other components
{td}
{td}
* [Apache Axis2/C verion 0.92|http://ws.apache.org/axis2/c/]
* [Libxml2 Parser version 2.6.20|http://xmlsoft.org/downloads.html]
{td}
{tr}
{table}