diff options
Diffstat (limited to 'das-cpp/trunk/GettingStarted.html')
| -rw-r--r-- | das-cpp/trunk/GettingStarted.html | 228 |
1 files changed, 228 insertions, 0 deletions
diff --git a/das-cpp/trunk/GettingStarted.html b/das-cpp/trunk/GettingStarted.html new file mode 100644 index 0000000000..c7aae47b5d --- /dev/null +++ b/das-cpp/trunk/GettingStarted.html @@ -0,0 +1,228 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+<HTML>
+<HEAD>
+ <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
+ <TITLE>Tuscany - Getting Started</TITLE>
+ <META NAME="GENERATOR" CONTENT="BrOffice.org 2.0 (Win32)">
+ <META NAME="CREATED" CONTENT="20070623;19202290">
+ <META NAME="CHANGEDBY" CONTENT="a a">
+ <META NAME="CHANGED" CONTENT="20070626;1131872">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+ <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
+ <STYLE>
+ <!--
+ TD P { color: #000000; font-family: "Verdana", "Helvetica", "Arial", sans-serif; font-size: 12pt }
+ H1 { color: #000000 }
+ P { color: #000000; font-family: "Verdana", "Helvetica", "Arial", sans-serif; font-size: 12pt }
+ H2 { background: #dddddd; border: 1px solid #999999; padding-top: 0.11cm; padding-bottom: 0.11cm; padding-left: 0.16cm; padding-right: 0.11cm; color: #990000 }
+ H3 { color: #000000 }
+ A:link { color: #3366aa; text-decoration: none }
+ -->
+ </STYLE>
+</HEAD>
+<BODY LANG="en-US" TEXT="#000000" LINK="#3366aa" DIR="LTR" STYLE="border: none; padding: 0cm">
+<DIV ID="bodyColumn" DIR="LTR">
+ <P ><BR><BR>
+ </P>
+ <DIV ID="contentBox" DIR="LTR">
+ <H1 ><FONT SIZE=6 STYLE="font-size: 28pt">Tuscany -
+ Getting Started - DAS C++</FONT></H1>
+ <P >This document describes what is needed to install
+ Tuscany DAS for C++. If you haven't already done so, the first step
+ is to download the DAS C++ from its repository:
+ <A HREF="https://svn.apache.org/repos/asf/incubator/tuscany/cpp/das/" TARGET="_blank">https://svn.apache.org/repos/asf/incubator/tuscany/cpp/das/</A>.
+ </P>
+ <H2 >Contents</H2>
+ <OL>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#requirements">System
+ Requirements</A>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#Installing">Installing
+ Tuscany DAS C++ on Windows.</A></P>
+ <LI><P STYLE="margin-bottom: 0cm"><A HREF="#samples">Samples</A>
+ </P>
+ <LI><P ><A HREF="#help">Getting Help</A>
+ </P>
+ </OL>
+ <H2 ><A NAME="requirements"></A>System Requirements</H2>
+ <P >In order to use Tuscany DAS there are some minimum
+ requirements:</P>
+ <TABLE WIDTH=896 BORDER=1 CELLPADDING=2 CELLSPACING=0>
+ <COL WIDTH=150>
+ <COL WIDTH=736>
+ <TR>
+ <TD WIDTH=150>
+ <P ><B>Software</B></P>
+ </TD>
+ <TD WIDTH=736>
+ <P ><B>Download Link</B></P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=150>
+ <P >Operating systems:
+ </P>
+ <UL>
+ <LI><P >Windows XP SP2
+ </P>
+ </UL>
+ </TD>
+ <TD WIDTH=736></TD>
+ </TR>
+ <TR>
+ <TD WIDTH=150>
+ <P >Tuscany SDO C++ (from the trunk)</P>
+ </TD>
+ <TD WIDTH=736>
+ <P >To compile and install Tuscany SDO C++ follow
+ the instructions on
+ <A HREF="https://svn.apache.org/repos/asf/incubator/tuscany/cpp/sdo/GettingStarted.html">https://svn.apache.org/repos/asf/incubator/tuscany/cpp/sdo/GettingStarted.html</A><FONT COLOR="#000000">
+ page. But instead of download the source from Tuscany downloads
+ page, download the SDO C++ source from the trunk:
+ <A HREF="https://svn.apache.org/repos/asf/incubator/tuscany/cpp/sdo/" TARGET="_blank">https://svn.apache.org/repos/asf/incubator/tuscany/cpp/sdo/</A></FONT></P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=150>
+ <P >libxml2 version 2.6.20
+ </P>
+ </TD>
+ <TD WIDTH=736>
+ <P >You need to download and install libxml2, iconv
+ and zlib from <A HREF="http://www.zlatkovic.com/libxml.en.html">http://www.zlatkovic.com/libxml.en.html</A>.
+ Please read the installation notes for libxml2 particularly
+ regarding it's pre-req's iconv and zlib on Windows.
+ </P>
+ </TD>
+ </TR>
+ <TR>
+ <TD WIDTH=150>
+ <P >iconv latest version</P>
+ </TD>
+ <TD WIDTH=736>
+ <P >You can find iconv for windows here:
+ <A HREF="http://sourceforge.net/project/downloading.php?groupname=gnuwin32&filename=libiconv-1.9.2-1-lib.zip">http://sourceforge.net/project/downloading.php?groupname=gnuwin32&filename=libiconv-1.9.2-1-lib.zip</A>&use_mirror=ufpr</P>
+ </TD>
+ </TR>
+ </TABLE>
+ <H2 ><A NAME="Installing"></A>Installing and Compiling
+ Tuscany DAS C++ on Windows</H2>
+ <h3>1. Downloading the Source Code</h3>
+ <OL>
+ <P STYLE="margin-bottom: 0cm">1.1 Download the
+ contents under
+ <A HREF="https://svn.apache.org/repos/asf/incubator/tuscany/cpp/das/">https://svn.apache.org/repos/asf/incubator/tuscany/cpp/das/</A><FONT COLOR="#000000">
+ into directory <tuscany_das_cpp>.</FONT></P>
+ </OL>
+ <h3>2. Preparing Environment</h3>
+ <OL>
+ <P STYLE="margin-bottom: 0cm">2.1 The following
+ environment variables are required:
+ </P>
+ <UL>
+ <LI><P STYLE="margin-bottom: 0cm">TUSCANY_SDOCPP=<path
+ to tuscany sdo for c++ directory>
+ </P>
+ <LI><P STYLE="margin-bottom: 0cm">LIBXML2_HOME=<path
+ to libxml2 directory>
+ </P>
+ <LI><P >ICONV_HOME=<path to iconv directory></P>
+ </UL>
+ </OL>
+ <h3>3. Compiling using Visual Studio Express</h3>
+ <OL START=3>
+ <P STYLE="margin-bottom: 0cm">3.1 Build the source
+ using Visual Studio Express solution under directory
+ <tuscany_das_cpp>/VSExpress/tuscany_das/.</P>
+ </OL>
+ <h3>4. Compiling using Apache Ant (does not compile test cases yet)</h3>
+ <OL START=3>
+ <P STYLE="margin-bottom: 0cm">4.1 Follow the instructions on <tuscany_das_cpp>/README_ANT_INSTALL to set up Apache Ant correctly.</P>
+ <P STYLE="margin-bottom: 0cm">4.2 Execute the following command on <tuscany_das_cpp> directory: <OL><P>ant</P></OL></P>
+ </OL>
+ <h3>5. Installing</h3>
+ <OL>
+ <P STYLE="margin-bottom: 0cm">5.1 Set environment
+ variable TUSCANY_DASCPP=<tuscany_das_cpp>/deploy/</P></LI>
+ </OL>
+
+ <H2 >Test Cases</H2>
+ <H3 >Setup</H3>
+ <UL>
+ <LI><P ><SPAN STYLE="text-decoration: none">Download
+ the latest version of Postgres Core and ODBC Driver. You can find it
+ here: <A HREF="http://www.postgresql.org/download/">http://www.postgresql.org/download/</A>.</SPAN></P>
+ <LI><P ><SPAN STYLE="text-decoration: none">Install both, Postgres Core and ODBC Driver, on your OS.</SPAN></P>
+ <LI><P >The test cases access a data source using DSN, das_test by default access a DSN named "DAStestcases" using "postgres" user with "tuscany" password. However this settings can be modified on getConnection function defined on <tuscany_das_cpp>/runtime/test/src/main.cpp:
+<P STYLE="margin-left: 2cm; margin-bottom: 0cm"><FONT SIZE=2>...<BR>std::string
+ dsn = <FONT COLOR="#800000">"DAStestcases"</FONT><FONT COLOR="#000000">;</FONT><BR><FONT COLOR="#000000">std::string
+ user = <FONT COLOR="#800000">"postgres"</FONT><FONT COLOR="#000000">;</FONT><BR><FONT COLOR="#000000">std::string
+ password = <FONT COLOR="#800000">"tuscany"</FONT<FONT COLOR="#000000">;</FONT><BR><FONT COLOR="#000000">...</FONT></FONT></FONT></P>
+
+ </UL>
+ <H3>Running</H3>
+ <OL>
+ <P >To run test cases you
+ just need to execute the file:
+ </P>
+ <UL>
+ <P STYLE="margin-bottom: 0cm"><tuscany_das_cpp>/VSExpress/tuscany_das/das_test/Debug/das_test.exe
+ </P>
+ </UL>
+ <P >The output of all tests must show “OK”.</P>
+ </OL>
+ <h3>Requirements:</h3>
+ <UL>
+ <LI><P >Postgres server must be running accepting connection from localhost.</P>
+ </UL>
+
+
+ <H2><A NAME="samples"></A>Samples</H2>
+ <TABLE BORDER=1 CELLPADDING=2 CELLSPACING=2>
+ <TR>
+ <TD>
+ <P >CompanySample</P>
+ </TD>
+ <TD>
+ <P >This sample shows how to load data from a RDB
+ source, using RDB DAS, into a SDO graph, then retrieve data
+ from it, modify the graph and update the data source based on the modified graph.
+ </P>
+ </TD>
+ </TR>
+ </TABLE>
+ <H2 ><A NAME="help"></A>Getting Help</H2>
+ <P >Any problem with this release can be reported to
+ the Tuscany <A HREF="http://cwiki.apache.org/TUSCANY/mailing-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>
+ <TABLE CELLPADDING=2 CELLSPACING=2>
+ <TR>
+ <TD>
+ <P >Thank you for your interest in Tuscany.</P>
+ <P ><EM><STRONG>-The Tuscany Development Team</STRONG></EM>
+ </P>
+ </TD>
+ </TR>
+ </TABLE>
+ </DIV>
+</DIV>
+</BODY>
+</HTML>
\ No newline at end of file |