Versions Compared

Old Version 6

changes.mady.by.user Luciano Resende

Saved on

compared with

New Version Current

changes.mady.by.user haleh mahbod

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3
Section
borderfalse
Column
width15%
Include Page
TUSCANYWIKI: SCA Native Subproject MenuTUSCANYWIKI:
SCA Native Subproject Menu
{panel:title= How to get involved in development of Java SCA? |borderStyle=solid|borderColor=#C3CDA1|titleBGColor=#C3CDA1|bgColor=#ECF4D1} This document is the development guideline for SCA Java project. * [General Guide|#General Guide] * [Getting Source code|#Getting Source] * [Setting up your development environment|#Setup] ** [Linux|#Setup Linux] ** [Windows|#Setup Windows] * [System Requirements|#System Requirements] * [Building the source code|#Building] {panel} h3. {anchor:General Guide}General Guide h3. {anchor:Getting Source}Getting Source code The main Tuscany project repository is located at

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
  • 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
h3. {anchor:Setup} Setting up your development environment Below you can find detailed instructions on how to configure the C++ runtime and tools for Linux or Windows. h4. {anchor: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: # Subversion - SVN version 1.3.0 or later is good (most Linux distros already include SVN). # Ant and a Java JDK are required by the SCA code generation tool used to generate proxies and wrappers for C++ components. ** Download

Column
width85%
Panel
borderColor#C3CDA1
bgColor#ECF4D1
titleBGColor#C3CDA1
titleHow to get involved in development of Java SCA?
borderStylesolid

This document is the development guideline for SCA Native project.

Anchor
General Guide
General Guide
General Guide

Anchor
Getting Source
Getting Source
Getting Source code

Wiki Markup
Anchor
Setup
Setup
Setting up your development environment

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
    • to
    • '$HOME/tuscany'
    • do
    • tar
    • xzf
    • apache-ant-1.6.5-bin.tar.gz.
** Configure your environment: *** export
    • Configure your environment:
      • export JAVA_HOME=$HOME/tuscany/jdk1.5.0_06
***
      • PATH=$JAVA_HOME/bin:$PATH
** Download JDK
    • Download JDK 5.0
    • from
    • java.sun.com.
** From
    • From $HOME/tuscany
    • run
    • jdk-1_5_0_06-linux-i586.bin,
    • this
    • will
    • extract
    • the
    • JDK
    • in
    • $HOME/tuscany/jdk1.5.0_06.
** Configure your environment: *** export
    • Configure your environment:
      • export JAVA_HOME=$HOME/tuscany/jdk1.5.0_06
***
      • 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.
** Configure your environment: *** export
    • Configure your environment:
      • export LIBXML2_LIB=/usr/lib
*** export
      • export LIBXML2_INCLUDE=/usr/include/libxml2
#
  2. Axis2C
  1. version
  1. 0.92.
** Download
    • Download axis2c-bin-0.92-linux.tar.gz
    • from
    • Apache.org.
** From
    • From $HOME/Tuscany
    • do
    • tar
    • xzf
    • axis2c-bin-0.92-linux.tar.gz,
    • this
    • will
    • install
    • Axis2C
    • in
    • $HOME/Tuscany/axis2c-bin-0.92-linux.
** Configure your environment: *** export
    • Configure your environment:
      • export AXIS2C_HOME=$HOME/tuscany/axis2c-bin-0.92-linux
*** export
      • export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$AXIS2C_HOME/lib
h4. {anchor: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,

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
  • Now select the User variable PATH. Select new if it doesn't
  • already
  • create
  • it.
* Append to the end the path to the
  • 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
  • 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:

HTML Table
Table Row (tr)
Table Cell (td)

Operating System

Table Cell (td)
  • Windows XP SP2
  • Linux
Table Row (tr)
Table Cell (td)

Other components

Table Cell (td)

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:

Code Block

    * 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}


h3. {anchor: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:

{code}
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
{code}

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:

{
Code Block
}
cd $HOME/tuscany/cpp/sdo
./sdotest.sh
{code}

To

build

the

SCA

C++

runtime:

{
Code Block
}
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
{code}

To

run

the

SCA

runtime

tests:

{
Code Block
}
cd $HOME/tuscany/cpp/sdo
./scatest.sh
{code}

To

run

the

SCA

calculator

sample:

{
Code Block
}
cd $HOME/tuscany/cpp/sca/deploy/samples/Calculator/deploy/bin
./runclient.sh
{code}