diff options
Diffstat (limited to '')
| -rw-r--r-- | branches/cpp-M1/sca/samples/GettingStarted.html | 261 |
1 files changed, 261 insertions, 0 deletions
diff --git a/branches/cpp-M1/sca/samples/GettingStarted.html b/branches/cpp-M1/sca/samples/GettingStarted.html new file mode 100644 index 0000000000..604de50ff9 --- /dev/null +++ b/branches/cpp-M1/sca/samples/GettingStarted.html @@ -0,0 +1,261 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> +<HTML> +<HEAD> + <META CONTENT="text/html; charset=iso-8859-1" HTTP-EQUIV="Content-Type"> + <META CONTENT="text/css" HTTP-EQUIV="Content-Style-Type"> + <STYLE MEDIA="all" TYPE="text/css"> +@import url("../doc/css/maven-base.css"); +@import url("../doc/css/maven-theme.css"); + </STYLE> + + <LINK HREF="../doc/css/maven-theme.css" MEDIA="print" REL="stylesheet" + TYPE="text/css"> + <TITLE>Tuscany SCA C++ Samples - Getting Started</TITLE> +</HEAD> + +<BODY> +<DIV ID="bodyColumn"> + <DIV ID="contentBox"> + <DIV CLASS="section"> + <H2>Tuscany Samples - Getting Started - SCA C++ Milestone release 1</H2> + + <P>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. + </P> + </DIV> + + <DIV CLASS="section"> + <H2>Contents</H2> + <OL> + <LI><A HREF="#linuxbld">Building the samples on Linux</A></LI> + <LI><A HREF="#linuxrun">Running the samples on Linux:</A></LI> + <UL> + <LI><A HREF="#linuxcalcbasic">Calculator with basic client</A></LI> + <LI><A HREF="#linuxcalcws">Calculator with Web Service client</A></LI> + </UL> + <LI><A HREF="#winbld">Building the samples on Windows</A></LI> + <LI><A HREF="#winrun">Running the samples on Windows:</A></LI> + <UL> + <LI><A HREF="#wincalcbasic">Calculator with basic client</A></LI> + <LI><A HREF="#wincalcws">Calculator with Web Service client</A></LI> + </UL> + </OL> + </DIV> + + + <DIV CLASS="section"> + <A NAME="linuxbld"><H2>Building the samples on Linux</H2></A> + <P>If using the binary distribution the samples are built and installed in + <tuscany_sca_install_dir>/samples - go directly to <A HREF="#linuxrun">Running the samples on Linux</A>.</P> + <OL> + <LI>The following environment variables are required: + <UL> + <LI>TUSCANY_SCACPP=<path to installed Tuscany SCA> + <LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO> + <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> + </UL></LI> + </LI> + <LI>Build the source with the following command sequence: + <UL> + <LI>cd <tuscany_sca_install_dir>/samples</LI> + <LI>./configure</LI> + <LI>make</LI> + <LI>make install</LI> + </UL> + NOTE: If you don't provide a --prefix configure option, it will by default install into + /usr/local/tuscany/sca/samples/Calculator</LI> + </OL> + </DIV> + + <DIV CLASS="section"> + <A NAME="linuxrun"><H2>Running the samples on Linux</H2></A> + <A NAME="linuxcalcbasic"><H3>Calculator with basic client</H3></A> + <OL> + <LI>The following environment variables are required: + <UL> + <LI>TUSCANY_SCACPP=<path to installed Tuscany SCA></LI> + <LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO></LI> + <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> + </UL> + </LI> + <LI>Run the sample with the following commands: + <UL> + <LI>cd <tuscany_sca_install_dir>/samples/Calculator/deploy/bin</LI> + <LI>./runclient.sh</LI> + </UL> + </LI> + </OL> + <A NAME="linuxcalcws"><H3>Calculator with Web Service client</H3></A> + <OL> + <LI>Deploy the Calculator as an Axis2C service: + <OL> + <LI>Create a new service folder in axis2:<BR/> + <AXIS2C_HOME>/services/Calculator</LI> + <LI>Copy the <TUSCANY_SCACPP>/samples/Calculator/CalculatorModule/services.xml + to <AXIS2C_HOME>/services/Calculator/services.xml</LI> + <LI>Edit the <AXIS2C_HOME>/services/Calculator/services.xml file to set the TuscanySystemRoot parameter to<BR/> + <parameter name="TuscanySystemRoot" locked="xsd:false"><tuscany_sca_install_dir>/samples/Calculator/deploy</parameter><BR/> + replacing <tuscany_sca_install_dir> with the install path of Tuscany SCA</LI> + <LI>Copy the <TUSCANY_SCACPP>/lib/libtuscany_sca_ws_service.so library into <AXIS2C_HOME>/services/Calculator</LI> + </OL> + </LI> + <LI>Start the Axis2C simple http server: + <OL> + <LI>cd <AXIS2C_HOME>/bin</LI> + <LI>The following environment variables are required: + <UL> + <LI>TUSCANY_SCACPP=<path to installed Tuscany SCA></LI> + <LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO></LI> + <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> + </UL> + </LI> + <LI>Add <TUSCANY_SCACPP>/lib, <TUSCANY_SDOCPP>/lib and <AXIS2C_HOME>/lib + to the LD_LIBRARY_PATH environment variable + </LI> + <LI>./axis2_http_server</LI> + </OL> + </LI> + <LI>Run the client: + <OL> + <LI>The following environment variable is required: + <UL> + <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> + </UL> + </LI> + <LI>cd <tuscany_sca_install_dir>/samples/Calculator/deploy/bin</LI> + <LI>./runwsclient.sh</LI> + </OL> + </LI> + </OL> + </DIV> + + <DIV CLASS="section"> + <A NAME="winbld"><H2>Building the samples on Windows</H2></A> + <P>If using the binary distribution the samples are built and installed in + <tuscany_sca_install_dir>/samples - go directly to <A HREF="#winrun">Running the samples on Windows</A>.</P> + <OL> + <LI>The following environment variables are required: + <UL> + <LI>TUSCANY_SCACPP=<path to installed Tuscany SCA> + <LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO> + <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> + </UL></LI> + </LI> + <LI>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. + </LI> + <LI>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. + </LI> + </OL> + </DIV> + + <DIV CLASS="section"> + <A NAME="winrun"><H2>Running the samples on Windows</H2></A> + <A NAME="wincalcbasic"><H3>Calculator with basic client</H3></A> + <OL> + <LI>The following environment variables are required: + <UL> + <LI>TUSCANY_SCACPP=<path to installed Tuscany SCA></LI> + <LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO></LI> + <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> + </UL> + </LI> + <LI>Run the sample with the following commands: + <UL> + <LI>cd <tuscany_sca_install_dir>/samples/Calculator/deploy/bin</LI> + <LI>runclient add 5 6<BR/> + (can also use sub, div, mul).</LI> + </UL> + </LI> + </OL> + <A NAME="wincalcws"><H3>Calculator with Web Service client</H3></A> + <OL> + <LI>Deploy the Calculator as an Axis2C service: + <OL> + <LI>Create a new service folder in axis2:<BR/> + <AXIS2C_HOME>/services/Calculator</LI> + <LI>Copy the <TUSCANY_SCACPP>/samples/Calculator/CalculatorModule/services.xml + to <AXIS2C_HOME>/services/Calculator/services.xml</LI> + <LI>Edit the <AXIS2C_HOME>/services/Calculator/services.xml file to set the TuscanySystemRoot parameter to<BR/> + <parameter name="TuscanySystemRoot" locked="xsd:false"><TUSCANY_SCACPP>/samples/Calculator/deploy</parameter><BR/> + replacing <TUSCANY_SCACPP> with the install path of Tuscany SCA</LI> + <LI>Copy the <TUSCANY_SCACPP>/lib/tuscany_sca_ws_service.dll (and .pdb if debugging) file(s) + into <AXIS2C_HOME>/services/Calculator</LI> + </OL> + </LI> + <LI>Start the Axis2C simple http server: + <OL> + <LI>cd <AXIS2C_HOME>/bin</LI> + <LI>The following environment variables are required: + <UL> + <LI>TUSCANY_SCACPP=<path to installed Tuscany SCA></LI> + <LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO></LI> + <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> + </UL> + </LI> + <LI>Add <TUSCANY_SCACPP>\bin, <TUSCANY_SDOCPP>\bin and <AXIS2C_HOME>/lib + to the PATH environment variable + </LI> + <LI>axis2_http_server</LI> + </OL> + </LI> + <LI>Run the client: + <OL> + <LI>The following environment variable is required: + <UL> + <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> + </UL> + </LI> + <LI>cd <tuscany_sca_install_dir>/samples/Calculator/deploy/bin</LI> + <LI>runwsclient</LI> + </OL> + </LI> + </OL> + </DIV> + + + <DIV CLASS="section"> + <A NAME="help"><H2>Getting Help</H2></A> + + <P>First place to look is at the Tuscany FAQ at + <A HREF="http://incubator.apache.org/tuscany/faq.html" + TARGET="_blank">http://incubator.apache.org/tuscany/faq.html</A> </P> + + <P>Any problem with this release can be reported to the Tuscany + <A HREF="http://incubator.apache.org/tuscany/mail-lists.html" + TARGET="_blank">mailing lists</A> or create a JIRA issue at <A HREF="http://issues.apache.org/jira/browse/Tuscany" + TARGET="_blank">http://issues.apache.org/jira/browse/Tuscany</A>.</P> + + + <P> </P> + + <P> </P> + + <P> </P> + <TABLE CLASS="bodyTable"> + <TBODY> + <TR CLASS="a"> + <TD> + + <P>Thank you for your interest in Tuscany.</P> <STRONG><EM>-The + Tuscany Development Team</EM></STRONG> + + <P></P> + + </TD> + </TR> + </TBODY> + </TABLE> + + <P></P> + </DIV> + </DIV> +</DIV> +</BODY> + +</HTML> |