From 636a7b7b97d2776b18d0ac06b1f653941e9f23a9 Mon Sep 17 00:00:00 2001 From: lresende Date: Sat, 21 Nov 2009 07:42:15 +0000 Subject: Moving site branches git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@882844 13f79535-47bb-0310-9956-ffa450edef68 --- .../site-publish/cpp_getting_started_m1.html | 847 +++++++++++++++++++++ 1 file changed, 847 insertions(+) create mode 100644 site/branches/site-20070701-mvnbased/site-publish/cpp_getting_started_m1.html (limited to 'site/branches/site-20070701-mvnbased/site-publish/cpp_getting_started_m1.html') diff --git a/site/branches/site-20070701-mvnbased/site-publish/cpp_getting_started_m1.html b/site/branches/site-20070701-mvnbased/site-publish/cpp_getting_started_m1.html new file mode 100644 index 0000000000..e7ca5ed6e5 --- /dev/null +++ b/site/branches/site-20070701-mvnbased/site-publish/cpp_getting_started_m1.html @@ -0,0 +1,847 @@ + + + + + + + + + + + + + + + + + + + + + + + + Tuscany - Getting Started with SCA C++ Milestone Release 1 + + + + + + + + + + + +
+ +
+ + + + + + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
+ + + + + + +
+ + + + + + + + + + + + + + + + + +
+ Tuscany General +
+
+
+ + + + + + +
+ Home +
+ News +
+ Documentation +
+ Releases +
+ Getting Started +
+ License +
+ ASF +
+
+
+ + + + + + +
+ + + + + + + + + + + + + + + + + +
+ Tuscany SCA +
+
+
+ + + + + + +
+ SCA Overview +
+ SCA Java +
+ SCA C++ +
+ SCA Docs. +
+ SCA Downloads +
+
+
+ + + + + + +
+ + + + + + + + + + + + + + + + + +
+ Tuscany SDO +
+
+
+ + + + + + +
+ SDO Overview +
+ SDO Java +
+ SDO C++ +
+ SDO Docs. +
+ SDO Downloads +
+
+
+ + + + + + +
+ + + + + + + + + + + + + + + + + +
+ Tuscany DAS +
+
+
+ + + + + + +
+ DAS Overview +
+ DAS Java +
+ DAS Docs. +
+ DAS Downloads +
+
+
+ + + + + + +
+ + + + + + + + + + + + + + + + + +
+ Community +
+
+
+ + + + + + +
+ Get Involved +
+ Mailing Lists +
+ FAQ +
+ Issue Tracking +
+ Wiki +
+ Blog +
+
+
+ + + + + + +
+ + + + + + + + + + + + + + + + + +
+ Development +
+
+
+ + + + + + +
+ Source Code +
+ Tuscany Java +
+ Tuscany C++ +
+ Tuscany WebSite +
+
+
+ 		+ + + + +
+ + + + + + + + +
+ + + + + + + + + + + + + + + + + + +
+ Getting Started with SCA C++ Milestone 1 Release +
+
+ + + + + + + + + + + + + + +
+

The first step would be to download the SCA C++ Milestone +Release 1 from our downloads page.

+
+

Contents

+
    +
  1. System Requirements
    2. +
  2. Installing Tuscany SCA.. +
    3. +
  3. Samples + +
    4. +
  4. User Guide Documents
    5. +
  5. Getting Help
    6. +
+
+
+

System Requirements

 + +

In order to run Tuscany SCA there are some + minimum requirements:

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
SoftwareDownload Link
Operating systems: +
    + +
  • Windows XP SP2
    • +
  • Linux
    • +
+ 		+
Axis2C Release 0.92 + http://ws.apache.org/axis2/c/download.cgi
+ Please download and follow the installation instructions. Ensure you can run the Axis2C samples +
Tuscany SDO for C++ Milestone Release 1 + http://incubator.apache.org/tuscany/download.html
+ Please download and follow the installation instructions +
Java SDK 1.4 or later + http://java.sun.com/javase/downloads/index.jsp
+ This is required for building and running the SCAGEN code generation tool, which is used + when developing Tuscany SCA C++ components +
Apache Ant 1.6 or later + http://ant.apache.org
+ This is required for building the SCAGEN code generation tool, which is used + when developing Tuscany SCA C++ components +
+
+
+

Installing Tuscany SCA for C++

 +

Getting Tuscany SCA for C++ working with the binary release on Linux

 +
    +
  1. Extract the binary tar package to a folder
    2. +
  2. Set the TUSCANY_SCACPP environment variable to point to the directory that was just extracted
    3. +
  3. Add the *install_dir*/lib directory to the LD_LIBRARY_PATH environment variable
    4. +
+

Getting Tuscany SCA for C++ working with the source release on Linux

 +
    +
  1. Extract the source tar package to a folder <tuscany_sca>
    2. +
  2. The following environment variables are required: +
      +
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
      • +
    • AXIS2C_HOME=<path to axis2c version 0.92>
      • +
    3. +
  3. Build the source with the following command sequence: +
      +
    • ./configure
      • +
    • make
      • +
    • make install
      • +
    + NOTE: If you don't provide a --prefix configure option, it will by default install into + /usr/local/tuscany/sca
    4. +
+ +

Getting Tuscany SCA for C++ working with the binary release on Windows

 +
    +
  1. Unzip the supplied zip file to a folder
    2. +
  2. Set the TUSCANY_SCACPP environment variable to point to the directory that was just unzipped
    3. +
  3. Add the *install_dir*\bin directory to the PATH environment variable
    4. +
+

Getting Tuscany SCA for C++ working with the source release on Windows

 +
    +
  1. Unzip the supplied source zip file
    2. +
  2. The following environment variables are required: +
      +
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
      • +
    • AXIS2C_HOME=<path to axis2c version 0.92>
      • +
    3. +
  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. +
  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 tuscany_sca.dsw in Visual Studio 6 - you can build projects individually + or build the samples to rebuild all the projects
    5. +
  5. Set the TUSCANY_SCACPP environment variable to point to the 'deploy' directory that was just created
    6. +
+
+
+

Samples

 +

Tuscany SCA C++ includes a simple technology sample that demonstrates some of the functionality of + the Tuscany SCA C++ runtime. This page describes what is needed to install and run the sample. +

+
+
+

Building the samples on Linux

 +

If using the binary distribution the samples are built and installed in + <tuscany_sca_install_dir>/samples - go directly to Running the samples on Linux.

+
    +
  1. The following environment variables are required: +
      +
    • TUSCANY_SCACPP=<path to installed Tuscany SCA>
      • +
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
      • +
    • AXIS2C_HOME=<path to axis2c version 0.92>
      • +
    2. +
  2. Build the source with the following command sequence: +
      +
    • cd <tuscany_sca_install_dir>/samples
      • +
    • ./configure
      • +
    • make
      • +
    • make install
      • +
    + NOTE: If you don't provide a --prefix configure option, it will by default install into + /usr/local/tuscany/sca/samples/Calculator
    3. +
+
+
+

Running the samples on Linux

 +

Calculator with basic client

 +
    +
  1. The following environment variables are required: +
      +
    • TUSCANY_SCACPP=<path to installed Tuscany SCA>
      • +
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
      • +
    • AXIS2C_HOME=<path to axis2c version 0.92>
      • +
    +
    2. +
  2. Run the sample with the following commands: +
      +
    • cd <tuscany_sca_install_dir>/samples/Calculator/deploy/bin
      • +
    • ./runclient.sh
      • +
    +
    3. +
+

Calculator with Web Service client

 +
    +
  1. Deploy the Calculator as an Axis2C service: +
      +
    1. Create a new service folder in axis2:
      + <AXIS2C_HOME>/services/Calculator
      2. +
    2. Copy the <TUSCANY_SCACPP>/samples/Calculator/CalculatorComposite/services.xml + to <AXIS2C_HOME>/services/Calculator/services.xml
      3. +
    3. Edit the <AXIS2C_HOME>/services/Calculator/services.xml file to set the TuscanySystemRoot parameter to
      + <parameter name="TuscanySystemRoot" locked="xsd:false"><tuscany_sca_install_dir>/samples/Calculator/deploy</parameter>
      + replacing <tuscany_sca_install_dir> with the install path of Tuscany SCA
      4. +
    4. Copy the <TUSCANY_SCACPP>/lib/libtuscany_sca_ws_service.so library into <AXIS2C_HOME>/services/Calculator
      5. +
    +
    2. +
  2. Start the Axis2C simple http server: +
      +
    1. cd <AXIS2C_HOME>/bin
      2. +
    2. The following environment variables are required: +
        +
      • TUSCANY_SCACPP=<path to installed Tuscany SCA>
        • +
      • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
        • +
      • AXIS2C_HOME=<path to axis2c version 0.92>
        • +
      +
      3. +
    3. Add <TUSCANY_SCACPP>/lib, <TUSCANY_SDOCPP>/lib and <AXIS2C_HOME>/lib + to the LD_LIBRARY_PATH environment variable +
      4. +
    4. ./axis2_http_server
      5. +
    +
    3. +
  3. Run the client: +
      +
    1. The following environment variable is required: +
        +
      • AXIS2C_HOME=<path to axis2c version 0.92>
        • +
      +
      2. +
    2. cd <tuscany_sca_install_dir>/samples/Calculator/deploy/bin
      3. +
    3. ./runwsclient.sh
      4. +
    +
    4. +
+
+
+

Building the samples on Windows

 +

If using the binary distribution the samples are built and installed in + <tuscany_sca_install_dir>/samples - go directly to Running the samples on Windows.

+
    +
  1. The following environment variables are required: +
      +
    • TUSCANY_SCACPP=<path to installed Tuscany SCA>
      • +
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
      • +
    • AXIS2C_HOME=<path to axis2c version 0.92>
      • +
    +
    2. +
  2. 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. +
    3. +
  3. Build the source, either via the Visual Studio 6 or 7 projects under + <tuscany_sca_install_dir>\samples\ides or via the command-line build file + found at <tuscany_sca_install_dir>\samples\ides\devstudio6\projects\Calculator\build.cmd + which will build and deploy the samples. +
    4. +
+
+
+

Running the samples on Windows

 +

Calculator with basic client

 +
    +
  1. The following environment variables are required: +
      +
    • TUSCANY_SCACPP=<path to installed Tuscany SCA>
      • +
    • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
      • +
    • AXIS2C_HOME=<path to axis2c version 0.92>
      • +
    +
    2. +
  2. Run the sample with the following commands: +
      +
    • cd <tuscany_sca_install_dir>/samples/Calculator/deploy/bin
      • +
    • runclient add 5 6
      + (can also use sub, div, mul).
      • +
    +
    3. +
+

Calculator with Web Service client

 +
    +
  1. Deploy the Calculator as an Axis2C service: +
      +
    1. Create a new service folder in axis2:
      + <AXIS2C_HOME>/services/Calculator
      2. +
    2. Copy the <TUSCANY_SCACPP>/samples/Calculator/CalculatorComposite/services.xml + to <AXIS2C_HOME>/services/Calculator/services.xml
      3. +
    3. Edit the <AXIS2C_HOME>/services/Calculator/services.xml file to set the TuscanySystemRoot parameter to
      + <parameter name="TuscanySystemRoot" locked="xsd:false"><TUSCANY_SCACPP>/samples/Calculator/deploy</parameter>
      + replacing <TUSCANY_SCACPP> with the install path of Tuscany SCA
      4. +
    4. Copy the <TUSCANY_SCACPP>/lib/tuscany_sca_ws_service.dll (and .pdb if debugging) file(s) + into <AXIS2C_HOME>/services/Calculator
      5. +
    +
    2. +
  2. Start the Axis2C simple http server: +
      +
    1. cd <AXIS2C_HOME>/bin
      2. +
    2. The following environment variables are required: +
        +
      • TUSCANY_SCACPP=<path to installed Tuscany SCA>
        • +
      • TUSCANY_SDOCPP=<path to installed Tuscany SDO>
        • +
      • AXIS2C_HOME=<path to axis2c version 0.92>
        • +
      +
      3. +
    3. Add <TUSCANY_SCACPP>\bin, <TUSCANY_SDOCPP>\bin and <AXIS2C_HOME>/lib + to the PATH environment variable +
      4. +
    4. axis2_http_server
      5. +
    +
    3. +
  3. Run the client: +
      +
    1. The following environment variable is required: +
        +
      • AXIS2C_HOME=<path to axis2c version 0.92>
        • +
      +
      2. +
    2. cd <tuscany_sca_install_dir>/samples/Calculator/deploy/bin
      3. +
    3. runwsclient
      4. +
    +
    4. +
+
+
+

User Guide Documents

 +

The SCA C++ Milestone release 1 also contains the following two documents to assist in developing with Tuscany SCA C++ +

+ + + + + + + + + + + +
Creating and building a Tuscany SCA C++ component + A document that describes how to create, build and run a Tuscany SCA C++ component. +
Enabling Web Service access to your Tuscany SCA C++ component + A document that describes how to expose a Tuscany SCA C++ component as a Web Service via an SCA Web Service Entrypoint. +
+
+
+

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.

+
+ 		+
+
+
+
+
+ Copyright © 2006, The Apache Software Foundation +Apache Tuscany is an effort undergoing incubation at The Apache Software Foundation (ASF), sponsored by the Web Services PMC. Incubation is required of all newly accepted projects until a further review indicates that the infrastructure, communications, and decision making process have stabilized in a manner consistent with other successful ASF projects. While incubation status is not necessarily a reflection of the completeness or stability of the code, it does indicate that the project has yet to be fully endorsed by the ASF. +
+ + + + + + + + + + + + + + + + + + + + + + -- cgit v1.2.3