| <!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 - Getting Started</TITLE> |
| </HEAD> |
| |
| <BODY> |
| <DIV ID="bodyColumn"> |
| <DIV ID="contentBox"> |
| <DIV CLASS="section"> |
| <H2>Tuscany - Getting Started - SDO C++ Milestone release 1</H2> |
| |
| <P>Tuscany SDO C++ is an implementation of the Service Data Objects 2.0 specification for C++ developers. |
| This page describes what is needed to install Tuscany SDO for C++.<BR/>If you haven't already done so, the first |
| step is to download the SDO C++ Milestone release 1 of Apache Tuscany from our |
| <A HREF="http://incubator.apache.org/tuscany/download.html" target='_blank'>download page</A>.<BR/> |
| </P> |
| </DIV> |
| <DIV CLASS="section"> |
| <H2>Contents</H2> |
| <OL> |
| <LI><A HREF="#requirements">System Requirements</A></LI> |
| <LI><A HREF="#install">Installing Tuscany SDO..</A> |
| <UL> |
| <LI><A HREF="#linuxbin">..from the binary release on Linux</A></LI> |
| <LI><A HREF="#linuxsrc">..from the source release on Linux</A></LI> |
| <LI><A HREF="#winbin">..from the binary release on Windows</A></LI> |
| <LI><A HREF="#winsrc">..from the source release on Windows</A></LI> |
| </UL></LI> |
| <LI><A HREF="#samples">Samples</A></LI> |
| <LI><A HREF="#help">Getting Help</A></LI> |
| </OL> |
| </DIV> |
| |
| <DIV CLASS="section"> |
| <A NAME="requirements"><H2>System Requirements</H2></A> |
| |
| <P>In order to use Tuscany SDO there are some minimum requirements:</P> |
| <TABLE CLASS="bodyTable"> |
| |
| <TBODY> |
| <TR CLASS="a"> |
| <TD><B>Software</B></TD> |
| <TD><B>Download Link</B></TD> |
| </TR> |
| <TR CLASS="b"> |
| <TD>Operating systems: |
| <UL> |
| <LI>Windows XP SP2</LI> |
| <LI>Linux</LI> |
| </UL> |
| </TD> |
| <TD> |
| </TD> |
| </TR> |
| <TR CLASS="a"> |
| <TD>Axis2C Release 0.92</TD> |
| |
| <TD> |
| <A HREF="http://ws.apache.org/axis2/c/download.cgi" |
| TARGET="_blank">http://ws.apache.org/axis2/c/download.cgi</A><BR/> |
| Please download and follow the installation instructions. Ensure you can run the Axis2C samples |
| </TD> |
| </TR> |
| <TR CLASS="b"> |
| <TD>libxml2 version 2.6.20</TD> |
| |
| <TD> |
| <A HREF="http://xmlsoft.org/downloads.html" |
| TARGET="_blank">http://xmlsoft.org/downloads.html</A><BR/> |
| Most Linux systems have libxml2 by default. On Windows you need to download and install libxml2 from <A HREF="http://www.zlatkovic.com/libxml.en.html" TARGET="_blank">http://www.zlatkovic.com/libxml.en.html</A><BR/> |
| Please read the installation notes for libxml2 particularly regarding it's pre-req's iconv and zlib on Windows. <BR/> |
| These libraries will need to be on the PATH in order to run Tuscany SDO. |
| </TD> |
| </TR> |
| </TBODY> |
| </TABLE> |
| </DIV> |
| <DIV CLASS="section"> |
| <A NAME="install"><H2>Installing Tuscany SDO for C++</H2></A> |
| <A NAME="linuxbin"><H3>Getting Tuscany SDO for C++ working with the binary release on Linux</H3></A> |
| <OL> |
| <LI>Extract the binary tar package to a folder</LI> |
| <LI>Add the *install_dir*/lib directory to the LD_LIBRARY_PATH environment variable</LI> |
| </OL> |
| <A NAME="linuxsrc"><H3>Getting Tuscany SDO for C++ working with the source release on Linux</H3></A> |
| <OL> |
| <LI>Extract the source tar package to a folder <tuscany_sdo></LI> |
| <LI>The following environment variables are required: |
| <UL> |
| <LI>LIBXML2_INCLUDE=<path to libxml2 includes> |
| <LI>LIBXML2_LIB=<path to libxml2 lib><BR/> |
| Note: If you are using the default installation of libxml2 these are usually:<BR/> |
| LIBXML2_LIB=/usr/lib<BR/> |
| LIBXML2_INCLUDE=/usr/include/libxml2<BR/></LI> |
| |
| <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> |
| </UL></LI> |
| <LI>Build the source with the following command sequence: |
| <UL> |
| <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/sdo</LI> |
| <LI>Run the test: |
| <UL> |
| <LI>cd to <tuscany_sdo>/runtime/core/test</LI> |
| <LI>./tuscany_sdo_test</LI> |
| </UL></LI> |
| </OL> |
| |
| <A NAME="winbin"><H3>Getting Tuscany SDO for C++ working with the binary release on Windows</H3></A> |
| <OL> |
| <LI>Unzip the supplied zip file to a folder</LI> |
| <LI>Add the *install_dir*\bin directory to the PATH environment variable</LI> |
| </OL> |
| <A NAME="winsrc"><H3>Getting Tuscany SDO for C++ working with the source release on Windows</H3></A> |
| <OL> |
| <LI>Unzip the supplied source zip file</LI> |
| <LI>The following environment variables are required: |
| <UL> |
| <LI>LIBXML2_HOME=<path to installed libxml2><BR/> |
| <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI> |
| </UL></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: |
| <UL> |
| <LI>cd <to where you unzipped the source></LI> |
| <LI>build</LI> |
| </UL> |
| This will build all the projects and put the required output into the 'deploy' directory<BR/><BR/> |
| Alternatively, open the workspace tuscany_sdo.dsw in Visual Studio 6 - you can build projects individually |
| or build the test project to build all its dependencies. Running the test project should give a list of |
| tests passed - this is currently 108 tests, no failures.</LI> |
| <LI>Add the 'deploy'\bin directory PATH environment variable</LI> |
| </OL> |
| </DIV> |
| |
| <DIV CLASS="section"> |
| <A NAME="samples"><H2>Samples</H2></A> |
| <TABLE CLASS="bodyTable"> |
| <TBODY> |
| <TR CLASS="a"> |
| <TD STYLE="vertical-align: top; white-space: nowrap;">SDO Technology samples |
| </TD> |
| <TD>Simple samples that emphasize how to to use SDO technology. Follow the |
| instructions on the samples <A HREF="samples/GettingStarted.html">Getting Started</A> |
| page to build and run the Tuscany SDO samples |
| </TD> |
| </TR> |
| </TBODY> |
| </TABLE> |
| </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> |
| |
