From 200a40b332420f94992eb39a6d0ea1cf1490ffc4 Mon Sep 17 00:00:00 2001 From: coreyg Date: Fri, 21 Nov 2014 09:30:19 +0000 Subject: Adding tuscany's website to their svn repo for svnpubsub git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@1640879 13f79535-47bb-0310-9956-ffa450edef68 --- .../site-publish/sca-native-developer-guide.html | 328 +++++++++++++++++++++ 1 file changed, 328 insertions(+) create mode 100644 site/trunk/site-publish/sca-native-developer-guide.html (limited to 'site/trunk/site-publish/sca-native-developer-guide.html') diff --git a/site/trunk/site-publish/sca-native-developer-guide.html b/site/trunk/site-publish/sca-native-developer-guide.html new file mode 100644 index 0000000000..0bcab1c479 --- /dev/null +++ b/site/trunk/site-publish/sca-native-developer-guide.html @@ -0,0 +1,328 @@ + + + + + + + + + + + + + + + Apache Tuscany : SCA Native Developer Guide + + + + + + + + + + + + + + + +
+ + + + +   + +
+ + +
+
+ + + + + + + + + +
+  Apache Tuscany > Home > SCA Overview > SCA Native > SCA Native Documentation Menu > SCA Native Developer Guide + + User List | Dev List | Issue Tracker   +
+ + + + + + + +
+ + +
+ +
+
+

+ + +
+ +
How to get involved in development of Java SCA?
+

This document is the development guideline for SCA Native project.

+ + +
+ +

General Guide

+ + +

Getting Source code

+ +

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
    • +
    +
  • +
+ + +

Setting up your development environment

+ +

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

+ +

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. +
  3. 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 JAVA_HOME=$HOME/tuscany/jdk1.5.0_06
      • +
      • PATH=$JAVA_HOME/bin:$PATH
      • +
      +
    • +
    • Download JDK 5.0 from java.sun.com.
    • +
    • 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 JAVA_HOME=$HOME/tuscany/jdk1.5.0_06
      • +
      • PATH=$JAVA_HOME/bin:$PATH
      • +
      +
    • +
    +
  4. +
  5. Libxml2 2.6.20 or later.Libxml2 is already in most Linux distros, just check that you have version 2.6.20 or later. To see which version of libxml2 is installed on your system do rpm -aq | grep libxml2. +
      +
    • Configure your environment: +
        +
      • export LIBXML2_LIB=/usr/lib
      • +
      • export LIBXML2_INCLUDE=/usr/include/libxml2
      • +
      +
    • +
    +
  6. +
  7. Axis2C version 0.92. +
      +
    • Download axis2c-bin-0.92-linux.tar.gz from Apache.org.
    • +
    • 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 AXIS2C_HOME=$HOME/tuscany/axis2c-bin-0.92-linux
      • +
      • export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$AXIS2C_HOME/lib
      • +
      +
    • +
    +
  8. +
+ + +

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.
  • +
+ + + +

System Requirements

+ +

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

+ +

Operating System

  • Windows XP SP2
  • Linux
  • Other components

    • Apache Axis2/C verion 0.92
    • Libxml2 Parser version 2.6.20
    • + + +

      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
      +
      +
      +
      +
      +
      +
      + + +
      + + + + + + website stats + + + + + + -- cgit v1.2.3