Tuscany SCA Native - SCA Binding Extension

This document describes the deployment and use of the SCA binding support in the Apache Tuscany SCA Native runtime.

The SCA binding allows components to be invoked via an implementation specific protocol. Currently, in the Tuscany SCA binding extension, the Axis2/C Web Service binding extension is used to provide the implementaion, so calls use the SOAP protocol

The HTTPDBigBank sample demonstrates the use of the SCA binding extension.

Contents

  1. System Requirements
  2. Installing the Tuscany SCA Binding Extension..
  3. Getting help

System Requirements

In order to install and use the Tuscany SCA Binding Extension there are some extra requirements in addition to the Tuscany SCA requirements:

Software Details
Tuscany Axis2/C Web Service binding extension Please follow the installation instructions. The Axis2/C Web Service extension requires Axis2/C version 0.96.

Installing the Tuscany SCA Binding Extension

Getting the Tuscany SCA Binding Extension working with the binary release on Linux and Mac OS X
  1. Ensure the AXIS2C_HOME environment variable is set to the Axis2/C installation
  2. Deploy the Axis2/C Web Services extension by following the deployment steps
  3. Ensure the Axis2/C Web Service extension and SCA Binding extension libraries are available on the LD_LIBRARY_PATH environment variable on Linux and the DYLD_LIBRARY_PATH environment variable on Mac OS X

Getting the Tuscany SCA Binding Extension working with the source release on Linux and Mac OS X
  1. You will need the Tuscany SCA and SDO libraries - follow the instructions here to build the SCA libraries and default extensions
  2. The following environment variables are required:
    • TUSCANY_SCACPP=<path to built Tuscany SCA>
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
  3. Build the SCA Binding source only with the following command sequence:
    • cd <tuscany_sca_install_dir>
    • ./configure --prefix=$TUSCANY_SCACPP --enable-scabinding --enable-cpp=no --enable-wsbinding=no
    • make
    • make install
    NOTE: If you don't provide a --prefix configure option, it will by default install into /usr/local/tuscany/sca

Getting the Tuscany SCA Binding Extension working with the binary release on Windows
  1. Ensure the AXIS2C_HOME environment variable is set to the Axis2/C installation
  2. Deploy the Axis2/C Web Services extension by following the deployment steps
  3. Ensure the Axis2/C Web Services extension and SCA Binding extension libraries are available on the PATH environment variable

Getting the Tuscany SCA Binding Extension working with the source release on Windows
  1. Unzip the supplied source zip file
  2. The following environment variables are required:
    • TUSCANY_SCACPP=<path to built Tuscany SCA>
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
  3. You must have set up the environment for Microsoft Visual C++ tools. The build command will call vcvars32 to set the environment. Ensure the directory containing this is on your path. This will be where you installed the compiler.
  4. Build the source:
    • cd <to where you unzipped the source>
    • build
    This will build all the projects and put the required output into the 'deploy' directory

    Alternatively, open the workspace at <tuscany_sca_install_dir>/projects/tuscany_sca/tuscany_sca.dsw in Visual Studio 6 or at at <tuscany_sca_install_dir>/projectsvc7/tuscany_sca/tuscany_sca.sln in Visual Studio 7.1 - you can build projects individually or build the samples to rebuild all the projects

Getting Help

First place to look is at the Tuscany FAQ at http://incubator.apache.org/tuscany/faq.html

Any problem with this release can be reported to the Tuscany mailing lists or create a JIRA issue at http://issues.apache.org/jira/browse/Tuscany.