Tuscany Sample Setup

Getting Tuscany Obtain Subversion Subversion

md tuscany
cd tuscany
svn co http://svn.apache.org/repos/asf/incubator/tuscany/java

Build Tuscany

cd java
mvn

Setup

J2SE setup

Tuscany applications can be run in a J2SE 5.0 environment. Before you can run Tuscany applications in that environment, the Tuscany runtime JAR files and the JAR files they depend on must be added to your J2SE classpath.
Samples not requiring invoking web services need at least the following jars in their classpath

asm-2.2.jar
common-2.2.0-RC4.jar
commons-logging-1.0.4.jar
concurrent-1.3.4.jar
ecore-2.2.0-RC4.jar
ecore-change-2.2.0-RC4.jar
ecore-xmi-2.2.0-RC4.jar
geronimo-connector-1.0.jar
geronimo-j2ee-connector_1.5_spec-1.0.jar
geronimo-jta_1.0.1B_spec-1.0.jar
geronimo-transaction-1.0.jar
js-1.6R2.jar
sca-api-incubating-M1.jar
sdo-api-incubating-M1.jar
stax-api-1.0.jar
tuscany-binding-jsonrpc-incubating-M1.jar
tuscany-common-incubating-M1.jar
tuscany-container-java-incubating-M1.jar
tuscany-container-rhino-incubating-M1.jar
tuscany-core-incubating-M1.jar
tuscany-databinding-sdo-incubating-M1.jar
tuscany-model-incubating-M1.jar
tuscany-sdo-impl-incubating-M1.jar
wsdl4j-1.5.2.jar
wstx-asl-2.9.3.jar
xbean-2.1.0.jar
xsd-2.2.0-RC4.jar

There is an ant script in java\testing\tomcat\build.xml that will produce in tuscany\java\testing\tomcat\target\j2se all the jars above once you have completed the full maven build at the root. Run "ant j2se" Use in java -Djava.ext.dirs to point to this directory to include all these jars.

If you're planning to use SCA Web Service bindings from your Tuscany application, add the following JAR files to your classpath:

axiom-api-1.0.jar
axiom-impl-1.0.jar
axis2-kernel-1.0.jar
commons-codec-1.3.jar
commons-httpclient-3.0.jar
commons-logging-1.0.3.jar
junit-3.8.1.jar
neethi-1.0.1.jar
tuscany-binding-axis2-incubating-M1.jar
XmlSchema-1.0.2.jar

here is an ant script in java\testing\tomcat\build.xml that will produce in tuscany\java\testing\tomcat\target\j2sews all the jars above once you have completed the full maven build at the root. Run "ant j2sews Use in java -Djava.ext.dirs to point to this directory to include all these jars.

Tomcat Setup

The setup and configuration of the Tomcat web server is a little more complex. If you are not interested in the details the easiest means of configuring this environment is by running "ant" in java\testing\tomcat that will configure a server that is ready to run the samples and deploy your own SCA applications..

For any other SCA application that is run in a Tomcat environment, package it as a standard J2EE war file and deploy it as usual. For Tomcat this is simply done by copying them to its webapps directory.

The details:

Unzip Tomcat to acceptance\target\apache-tomcat-5.5.15

Add org.apache.Tuscany.tomcat.lifecycle.listener.TomcatServerLifecycleListener to conf\server.xml

Change
the Host element to add

className="org.apache.tuscany.tomcat.TuscanyHost" attribute like this

:

     
<Host className="org.apache.tuscany.tomcat.TuscanyHost"
name="localhost" appBase="webapps"
unpackWARs="true"
autoDeploy="true" xmlValidation="false"
xmlNamespaceAware="false">

The following jars need to be placed in tomcats common/lib directory

	common-2.2.0-snapshot.jar
	ecore-2.2.0-snapshot.jar
	ecore-change-2.2.0-snapshot.jar
	ecore-xmi-2.2.0-snapshot.jar
	js-1.6r2.jar
	sca-api-incubating-m1.jar
	sdo-api-incubating-m1.jar
	stax-api-1.0.jar
	tuscany-das-rdb-incubating-m1.jar
	tuscany-sdo-impl-incubating-m1.jar
	wstx-asl-2.9.3.jar
	xbean-2.1.0.jar
	xsd-2.2.0-snapshot.jar
	jsonrpc-1.0.jar Optional if you want javascript components
	derby-10.1.2.1.jar Optional if you want database support

The following jars need to go into the server/lib

	asm-2.2.jar
  	axiom-api-1.0.jar
  	axiom-impl-1.0.jar
  	axis2-kernel-1.0.jar
  	commons-codec-1.3.jar
  	commons-httpclient-3.0.jar
  	commons-logging-1.0.4.jar
  	concurrent-1.3.4.jar
  	geronimo-connector-1.0.jar
  	geronimo-j2ee-connector_1.5_spec-1.0.jar
  	geronimo-jta_1.0.1b_spec-1.0.jar
  	geronimo-transaction-1.0.jar
  	neethi-1.0.1.jar
  	tuscany-binding-axis2-incubating-m1.jar
  	tuscany-binding-jsonrpc-incubating-m1.jar
  	tuscany-common-incubating-m1.jar
  	tuscany-container-java-incubating-m1.jar
  	tuscany-container-rhino-incubating-m1.jar
  	tuscany-core-incubating-m1.jar
  	tuscany-databinding-sdo-incubating-m1.jar
  	tuscany-model-incubating-m1.jar
  	tuscany-tomcat-incubating-m1.jar
  	wsdl4j-1.5.2.jar
  	xmlschema-1.0.2.jar

or the samples copy their war files to Tomcat's webapps directory.