Tuscany - + Getting Started - DAS C++

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: + https://svn.apache.org/repos/asf/incubator/tuscany/cpp/das/. +

System + Requirements +
+
Installing + Tuscany DAS C++ on Windows.
+
Samples +
+
Getting Help +
+

System Requirements

In order to use Tuscany DAS there are some minimum + requirements:

+ + + + + + + + + + + + + + + + + + + + + + + +

+ Software +	+ Download Link +
+ Operating systems: + + + Windows XP SP2 + + +
+ Tuscany SDO C++ (from the trunk) +	+ To compile and install Tuscany SDO C++ follow + the instructions on + https://svn.apache.org/repos/asf/incubator/tuscany/cpp/sdo/GettingStarted.html + page. But instead of download the source from Tuscany downloads + page, download the SDO C++ source from the trunk: + https://svn.apache.org/repos/asf/incubator/tuscany/cpp/sdo/ +
+ libxml2 version 2.6.20 + +	+ You need to download and install libxml2, iconv + and zlib from http://www.zlatkovic.com/libxml.en.html. + Please read the installation notes for libxml2 particularly + regarding it's pre-req's iconv and zlib on Windows. + +
+ iconv latest version +	+ You can find iconv for windows here: + http://sourceforge.net/project/downloading.php?groupname=gnuwin32&filename=libiconv-1.9.2-1-lib.zip&use_mirror=ufpr +

Installing and Compiling + Tuscany DAS C++ on Windows

1. Downloading the Source Code

1.1 Download the + contents under + https://svn.apache.org/repos/asf/incubator/tuscany/cpp/das/ + into directory <tuscany_das_cpp>.

2. Preparing Environment

2.1 The following + environment variables are required: +

TUSCANY_SDOCPP=<path + to tuscany sdo for c++ directory> +
+
LIBXML2_HOME=<path + to libxml2 directory> +
+
ICONV_HOME=<path to iconv directory>
+

3. Compiling using Visual Studio Express

3.1 Build the source + using Visual Studio Express solution under directory + <tuscany_das_cpp>/VSExpress/tuscany_das/.

4. Compiling using Apache Ant (does not compile test cases yet)

4.1 Follow the instructions on <tuscany_das_cpp>/README_ANT_INSTALL to set up Apache Ant correctly.

4.2 Execute the following command on <tuscany_das_cpp> directory:

ant

5. Installing

5.1 Set environment + variable TUSCANY_DASCPP=<tuscany_das_cpp>/deploy/

+ +

Test Cases

Setup

Download + the latest version of Postgres Core and ODBC Driver. You can find it + here: http://www.postgresql.org/download/.
+
Install both, Postgres Core and ODBC Driver, on your OS.
+
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: +
...
std::string + dsn = "DAStestcases";
std::string + user = "postgres";
std::string + password = "tuscany";
...
+ +

Running

To run test cases you + just need to execute the file: +

<tuscany_das_cpp>/VSExpress/tuscany_das/das_test/Debug/das_test.exe +

The output of all tests must show “OK”.

Requirements:

Postgres server must be running accepting connection from localhost.
+

+ + +

Samples

+ + + + + +

CompanySample

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. +

Getting Help

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.

+ + + + +

Thank you for your interest in Tuscany.

-The Tuscany Development Team +