You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tuscany.apache.org by js...@apache.org on 2006/05/17 09:03:13 UTC
svn commit: r407179 - in /incubator/tuscany/java/docs: sampleSetup.htm
setup.htm
Author: jsdelfino
Date: Wed May 17 00:03:13 2006
New Revision: 407179
URL: http://svn.apache.org/viewcvs?rev=407179&view=rev
Log:
renamed sampleSetup.htm to setup.htm, this doc is not just for the samples
Added:
incubator/tuscany/java/docs/setup.htm
Removed:
incubator/tuscany/java/docs/sampleSetup.htm
Added: incubator/tuscany/java/docs/setup.htm
URL: http://svn.apache.org/viewcvs/incubator/tuscany/java/docs/setup.htm?rev=407179&view=auto
==============================================================================
--- incubator/tuscany/java/docs/setup.htm (added)
+++ incubator/tuscany/java/docs/setup.htm Wed May 17 00:03:13 2006
@@ -0,0 +1,134 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html><head><!-- Copyright (c) 2005 The Apache Software Foundation or its licensors,
+as applicable. Licensed 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 content="text/html; charset=iso-8859-1" http-equiv="Content-Type"><meta content="text/css" http-equiv="Content-Style-Type"><title>Tuscany Sample Setup</title><!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
+<style type="text/css" media="all">
+@import url("../../css/maven-base.css");
+@import url("../../css/maven-theme.css");
+@import url("../../css/site.css");
+</style><link rel="stylesheet" href="./css/print.css" type="text/css" media="print"></head>
+<body>
+<h2>Tuscany Sample Setup</h2><h3></h3><h3><a name="Samples"></a>Samples </h3>Tuscany
+ samples are divided into the categories listed in the
+table below. If you are working from a binary distribution there is no
+need to follow any of the setup information provided in the following sections. <br>The only requirement for the web based demos is that you have the tomcat server in your distribution running:<br><ul><li>Change the directory to <span style="font-weight: bold;">apache-tomcat-5.5.17\bin</span></li><li>Execute: <code>startup</code></li></ul>The sections following this describe how to build and setup Tuscany from its source.
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2"><caption style="text-decoration: underline;">Tuscany
+samples and applications</caption><tbody>
+<tr><td style="vertical-align: top; white-space: nowrap;"><span style="text-decoration: underline;"></span><a href="../samples/sca/readme.htm">SCA Technology samples</a>
+</td><td>Simple samples that emphasizes how to to use Service Component Architecture technology.<br>
+</td></tr>
+<tr><td><a href="../samples/das/companyweb/readme.htm">DAS Technology samples</a></td><td>Simple samples that emphasizes how to use Data Access Services.</td></tr><tr><td style="vertical-align: top; white-space: nowrap;">
+<a href="../sampleapps/readme.htm">Sample
+applications</a></td>
+<td>Sample business applications that show SCA
+and SDO.<br>
+<br></td>
+</tr></tbody>
+</table>
+<br><hr style="width: 100%; height: 2px;"><br>
+<h3>Getting
+Tuscany</h3>
+Obtain Subversion <a target="_blank" href="http://subversion.tigris.org/">Subversion</a><br>
+<ul><li>md
+tuscany</li>
+<li>cd tuscany</li>
+<li>svn co
+http://svn.apache.org/repos/asf/incubator/tuscany/java</li>
+</ul><h3> Build
+Tuscany </h3>
+Obtain <a target="_blank" href="http://maven.apache.org/">Maven
+2.0.2</a><br>
+<ul><li>cd
+java</li>
+<li>mvn</li>
+</ul><h3>Setup</h3>
+<h4><a name="J2SE_setup"></a>J2SE
+setup</h4>
+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.<br>
+Samples not requiring invoking web
+services
+need at least the following jars in their classpath<br>
+<a name="#J2SEJARSNWS"></a><br><table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2">
+<tbody><tr>
+<td><pre style="margin-left: 40px;">asm-2.2.jar<br>common-2.2.0-RC4.jar<br>commons-logging-1.0.4.jar<br>concurrent-1.3.4.jar<br>ecore-2.2.0-RC4.jar<br>ecore-change-2.2.0-RC4.jar<br>ecore-xmi-2.2.0-RC4.jar<br>geronimo-connector-1.0.jar<br>geronimo-j2ee-connector_1.5_spec-1.0.jar<br>geronimo-jta_1.0.1B_spec-1.0.jar<br>geronimo-transaction-1.0.jar<br>js-1.6R2.jar<br>sca-api-incubating-M1.jar<br>sdo-api-incubating-M1.jar<br>stax-api-1.0.jar<br>tuscany-binding-jsonrpc-incubating-M1.jar<br>tuscany-common-incubating-M1.jar<br>tuscany-container-java-incubating-M1.jar<br>tuscany-container-rhino-incubating-M1.jar<br>tuscany-core-incubating-M1.jar<br>tuscany-databinding-sdo-incubating-M1.jar<br>tuscany-model-incubating-M1.jar<br>tuscany-sdo-impl-incubating-M1.jar<br>wsdl4j-1.5.2.jar<br>wstx-asl-2.9.3.jar<br>xbean-2.1.0.jar<br>xsd-2.2.0-RC4.jar</pre>
+</td></tr>
+</tbody></table>
+<span style="font-style: italic;">There is an <a href="http://ant.apache.org/bindownload.cgi" target="_blank">ant</a>
+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 "<span style="font-weight: bold;">ant j2se</span>"
+ Use in java -Djava.ext.dirs to point to this directory to
+include all these jars.</span><br>
+<br>If
+you're planning to use SCA Web Service bindings from your Tuscany
+application, add the following JAR files to your classpath:<br>
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2"><tbody>
+<tr><td>
+<pre style="margin-left: 40px;">axiom-api-1.0.jar<br>axiom-impl-1.0.jar<br>axis2-kernel-1.0.jar<br>commons-codec-1.3.jar<br>commons-httpclient-3.0.jar<br>commons-logging-1.0.3.jar<br>junit-3.8.1.jar<br>neethi-1.0.1.jar<br>tuscany-binding-axis2-incubating-M1.jar<br>XmlSchema-1.0.2.jar</pre></td>
+</tr></tbody>
+</table><span style="font-style: italic;">here is an
+<a href="http://ant.apache.org/bindownload.cgi" target="_blank">ant</a>
+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 "<span style="font-weight: bold;">ant j2sews</span>
+ Use in java -Djava.ext.dirs to point to this directory to
+include all these jars.</span>
+<h4><a name="Tomcat_Setup"></a>Tomcat
+Setup</h4>
+<p>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 <span style="font-style: italic;">java\testing\tomcat </span>that
+will configure a server that is
+ready to run the samples and deploy your own SCA applications..</p>
+<p>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. </p>
+<p>The
+details:</p>
+<ul compact="compact"><li>Unzip
+Tomcat to acceptance\target\apache-tomcat-5.5.15 </li>
+<li>Add
+org.apache.Tuscany.tomcat.lifecycle.listener.TomcatServerLifecycleListener
+to conf\server.xml<br>
+<table style="width: 100%; text-align: left; margin-left: auto; margin-right: auto;" border="1" cellpadding="2" cellspacing="2"><tbody>
+<tr><td style="background-color: rgb(204, 204, 204);"><code>Change
+the Host element to add </code><span style="font-weight: bold;">className="org.apache.tuscany.tomcat.TuscanyHost"</span>
+attribute like this<code>:<br>
+
+<Host <span style="color: rgb(255, 0, 0);">className="org.apache.tuscany.tomcat.TuscanyHost"
+</span>name="localhost" appBase="webapps"
+unpackWARs="true"
+autoDeploy="true" xmlValidation="false"
+xmlNamespaceAware="false"><br>
+<br></code></td>
+</tr></tbody>
+</table><p>The following jars need to be placed in tomcats
+common/lib directory</p>
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2"><tbody>
+<tr><td>
+<pre> common-2.2.0-snapshot.jar<br> ecore-2.2.0-snapshot.jar<br> ecore-change-2.2.0-snapshot.jar<br> ecore-xmi-2.2.0-snapshot.jar<br> js-1.6r2.jar<br> sca-api-incubating-m1.jar<br> sdo-api-incubating-m1.jar<br> stax-api-1.0.jar<br> tuscany-das-rdb-incubating-m1.jar<br> tuscany-sdo-impl-incubating-m1.jar<br> wstx-asl-2.9.3.jar<br> xbean-2.1.0.jar<br> xsd-2.2.0-snapshot.jar<br> jsonrpc-1.0.jar <span style="font-style: italic;"><span style="font-weight: bold;">Optional if you want javascript components</span></span><br><span style="font-style: italic;"><span style="font-weight: bold;"></span></span> derby-10.1.2.1.jar <span style="font-style: italic;"><span style="font-weight: bold;">Optional if you want database support</span></span></pre></td>
+</tr></tbody>
+</table></li>
+<li><p>The
+following jars need to go into the server/lib</p>
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2" cellspacing="2"><tbody>
+<tr><td>
+<pre> asm-2.2.jar<br> axiom-api-1.0.jar<br> axiom-impl-1.0.jar<br> axis2-kernel-1.0.jar<br> commons-codec-1.3.jar<br> commons-httpclient-3.0.jar<br> commons-logging-1.0.4.jar<br> concurrent-1.3.4.jar<br> geronimo-connector-1.0.jar<br> geronimo-j2ee-connector_1.5_spec-1.0.jar<br> geronimo-jta_1.0.1b_spec-1.0.jar<br> geronimo-transaction-1.0.jar<br> neethi-1.0.1.jar<br> tuscany-binding-axis2-incubating-m1.jar<br> tuscany-binding-jsonrpc-incubating-m1.jar<br> tuscany-common-incubating-m1.jar<br> tuscany-container-java-incubating-m1.jar<br> tuscany-container-rhino-incubating-m1.jar<br> tuscany-core-incubating-m1.jar<br> tuscany-databinding-sdo-incubating-m1.jar<br> tuscany-model-incubating-m1.jar<br> tuscany-tomcat-incubating-m1.jar<br> wsdl4j-1.5.2.jar<br> xmlschema-1.0.2.jar</pre></td>
+</tr></tbody>
+</table></li>
+<li>or
+the samples copy their war files to Tomcat's webapps
+directory.</li>
+</ul>
+</body></html>
\ No newline at end of file