Dear Wiki user,
You have subscribed to a wiki page or wiki category on
"Ws Wiki" for change notification.
The following page has been changed by JeanSebastienDelfino:
ht
tp://wiki.apache.org/ws/Tuscany/GetTuscany/Linux
------------------------------------------------------------
------------------
+ = Building Tuscany on Linux =
+
- This document describes the detailed steps to setup your
system, download the Tuscany source code, build the Tuscany
runtime, run two SCA samples, a simple J2SE program and a
Web application invoking a Hello``World SCA service.
+ This document describes the detailed steps to setup your
system, download the Tuscany source code, build the Tuscany
runtime and run two SCA samples, a simple J2SE program and a
Web application invoking a Hello``World SCA service.
These instructions have been tested on a Red``Hat Linux
Enterprise 4 system.
 -14, +16
= Creating a tuscany directory =
Open a terminal window, then from the shell prompt create
a tuscany directory as follows:
{{{
- mkdir tuscany
+ mkdir ~/tuscany
- cd tuscany
+ cd ~/tuscany
}}}
- We're going to download all the tuscany code and the
required dependencies in this directory.
+ We're going to download all the Tuscany code and the
required dependencies in this directory.
= Downloading and installing the Java JDK 5.0 =
Point your Web browser to http://j
ava.sun.com/j2se/1.5.0/download.jsp.
-27, +29
Accept the License agreement, then select Linux
self-extracting file - jdk-1_5_0_06-linux-i586.bin.
- Download jdk-1_5_0_06-linux-i586.bin to the tuscany
directory.
+ Download jdk-1_5_0_06-linux-i586.bin to the ~/tuscany
directory.
From the shell prompt do the following:
{{{
-38, +40
Modify your user profile ($HOME/.bashrc if you're using
bash) and add the following lines:
{{{
- JAVA_HOME=$HOME/tuscany/jdk1.5.0_06
+ JAVA_HOME=~/tuscany/jdk1.5.0_06
export JAVA_HOME
PATH=$JAVA_HOME/bin:$PATH
}}}
-48, +50
Select "Maven 2.0.4 (tar.gz) -
maven-2.0.4-bin.tar.gz".
- Download maven-2.0.4-bin.tar.gz to the tuscany directory.
+ Download maven-2.0.4-bin.tar.gz to the ~/tuscany
directory.
From the shell prompt do the following:
{{{
- tar xzvf maven-2.0.4-bin.tar.gz
+ tar xzvf maven-2.0.4-bin.tar.gz
}}}
- This will extract Maven 2.0.4 under tuscany/maven-2.0.4.
+ This will extract Maven 2.0.4 to the ~/tuscany/maven-2.0.4
directory.
Modify your user profile and add the following lines:
{{{
- MVN_HOME=$HOME/tuscany/maven-2.0.4
+ MVN_HOME=~/tuscany/maven-2.0.4
export MVN_HOME
PATH=$MVN_HOME/bin:$PATH
}}}
-68, +70
Select ".tar.gz archive:
apache-ant-1.6.5-bin.tar.gz".
- Download apache-ant-1.6.5-bin.tar.gz to the tuscany
directory.
+ Download apache-ant-1.6.5-bin.tar.gz to the ~/tuscany
directory.
From the shell prompt do the following:
{{{
tar xzvf apache-ant-1.6.5-bin.tar.gz
}}}
- This will extract Ant 1.6.5 under
tuscany/apache-ant-1.6.5.
+ This will extract Ant 1.6.5 to the
~/tuscany/apache-ant-1.6.5 directory.
Modify your user profile and add the following lines:
{{{
- ANT_HOME=$HOME/tuscany/apache-ant-1.6.5
+ ANT_HOME=~/tuscany/apache-ant-1.6.5
export ANT_HOME
PATH=$ANT_HOME/bin:$PATH
}}}
-86, +88
= Downloading and installing Subversion 1.3.0 =
Point your Web browser to h
ttp://subversion.tigris.org/project_packages.html.
- Pick a Subversion RPM package for your system, for example
for a Red``Hat Enterprise Linux 4 pick http://summersoft
.fay.ar.us/pub/subversion/latest/rhel-4/bin/subversion-1.3.0
-1.rhel4.i386.rpm.
+ Pick a Subversion RPM package for your system, for example
for a Red``Hat Enterprise Linux 4 system pick http://summersoft
.fay.ar.us/pub/subversion/latest/rhel-4/bin/subversion-1.3.0
-1.rhel4.i386.rpm.
- Download subversion-1.3.0-1.rhel4.i386.rpm to the tuscany
directory.
+ Download subversion-1.3.0-1.rhel4.i386.rpm to the
~/tuscany directory.
From the shell prompt do the following:
{{{
-121,
+123
From the shell prompt, do the following:
{{{
- cd tuscany
+ cd ~/tuscany
svn co http://svn.apache.org/repos/asf/incubator/tuscany/java
}}}
- This should check out all the source code from the Tuscany
SVN repository into the tuscany/java directory.
+ This should check out all the source code from the Tuscany
SVN repository into the ~/tuscany/java directory.
When the check out completes, do the following:
{{{
-136,
+138
http://people.apache.org/~jsdelfino/
wiki/screencaps/linux/verifycheckout.jpg
- You are now ready to build Tuscany.
+ You are now ready to build the Tuscany runtime.
= Building the Tuscany runtime =
From the shell prompt do the following:
{{{
- cd $HOME/tuscany/java
+ cd ~/tuscany/java
mvn
}}}
- This will build Tuscany with Maven. Maven will download
all the dependency JARs, build all the Tuscany sub-projects
and run the unit tests.
+ This will build the Tuscany runtime with Maven. Maven will
download all the JAR dependencies, build all the Tuscany
sub-projects and run the unit tests.
When the build completes you should see the following:
-154,
+156
= Running the HelloWord sample =
To run the Hello``World sample you need to have the
following JARs on your Java classpath:
{{{
-
$HOME/.m2/repository/org/osoa/sca-api/SNAPSHOT/sca-api-SNAPS
HOT.jar
+
~/.m2/repository/org/osoa/sca-api/SNAPSHOT/sca-api-SNAPSHOT.
jar
-
$HOME/.m2/repository/org/apache/tuscany/tuscany-common/SNAPS
HOT/tuscany-common-SNAPSHOT.jar
+
~/.m2/repository/org/apache/tuscany/tuscany-common/SNAPSHOT/
tuscany-common-SNAPSHOT.jar
-
$HOME/.m2/repository/org/apache/tuscany/tuscany-core/SNAPSHO
T/tuscany-core-SNAPSHOT.jar
+
~/.m2/repository/org/apache/tuscany/tuscany-core/SNAPSHOT/tu
scany-core-SNAPSHOT.jar
-
$HOME/.m2/repository/org/apache/tuscany/tuscany-model/SNAPSH
OT/tuscany-model-SNAPSHOT.jar
+
~/.m2/repository/org/apache/tuscany/tuscany-model/SNAPSHOT/t
uscany-model-SNAPSHOT.jar
-
$HOME/.m2/repository/axis/axis-wsdl4j/1.2/axis-wsdl4j-1.2.ja
r
+ ~/.m2/repository/axis/axis-wsdl4j/1.2/axis-wsdl4j-1.2.jar
-
$HOME/.m2/repository/commonj/sdo-api/SNAPSHOT/sdo-api-SNAPSH
OT.jar
+
~/.m2/repository/commonj/sdo-api/SNAPSHOT/sdo-api-SNAPSHOT.j
ar
-
$HOME/.m2/repository/org/apache/tuscany/tuscany-sdo-impl/SNA
PSHOT/tuscany-sdo-impl-SNAPSHOT.jar
+
~/.m2/repository/org/apache/tuscany/tuscany-sdo-impl/SNAPSHO
T/tuscany-sdo-impl-SNAPSHOT.jar
-
$HOME/.m2/repository/org/eclipse/emf/ecore/2.2.0-SNAPSHOT/ec
ore-2.2.0-SNAPSHOT.jar
+
~/.m2/repository/org/eclipse/emf/ecore/2.2.0-SNAPSHOT/ecore-
2.2.0-SNAPSHOT.jar
-
$HOME/.m2/repository/org/eclipse/emf/common/2.2.0-SNAPSHOT/c
ommon-2.2.0-SNAPSHOT.jar
+
~/.m2/repository/org/eclipse/emf/common/2.2.0-SNAPSHOT/commo
n-2.2.0-SNAPSHOT.jar
-
$HOME/.m2/repository/org/eclipse/emf/ecore-change/2.2.0-SNAP
SHOT/ecore-change-2.2.0-SNAPSHOT.jar
+
~/.m2/repository/org/eclipse/emf/ecore-change/2.2.0-SNAPSHOT
/ecore-change-2.2.0-SNAPSHOT.jar
- $HOME/.m2/repository/stax/stax-api/1.0/stax-api-1.0.jar
+ ~/.m2/repository/stax/stax-api/1.0/stax-api-1.0.jar
-
$HOME/.m2/repository/woodstox/wstx-asl/2.8.2/wstx-asl-2.8.2.
jar
+
~/.m2/repository/woodstox/wstx-asl/2.8.2/wstx-asl-2.8.2.jar
- $HOME/.m2/repository/org/apache/tuscany/sca/containers/
-
$HOME/.m2/repository/org/apache/tuscany/sca/containers/tusca
ny-container-java/SNAPSHOT/tuscany-container-java-SNAPSHOT.j
ar
+
~/.m2/repository/org/apache/tuscany/sca/containers/tuscany-c
ontainer-java/SNAPSHOT/tuscany-container-java-SNAPSHOT.jar
}}}
- Instead of copying all these JARs by hand, you can use one
of the Tuscany build scripts to create a directory with a
copy of all the required JARs.
+ Instead of copying all the JARs by hand, you can use one
of the Tuscany build scripts to create a directory
containing all the required JARs.
From the shell prompt, do the following:
{{{
- ant -f $HOME/tuscany/java/testing/tomcat/build.xml
-Dtuscany.acceptance.target.dir=$HOME/tuscany/java/target
j2se
+ ant -f ~/tuscany/java/testing/tomcat/build.xml
-Dtuscany.acceptance.target.dir=~/tuscany/java/target j2se
}}}
- This will copy all the required JARs into directory
tuscany/java/target/j2se. From the shell prompt do the
following:
+ This will copy all the required JARs into directory
~/tuscany/java/target/j2se.
+
+ From the shell prompt do the following:
{{{
- ls
+ ls target/j2se
}}}
You should see the following:
-195,
+198
http://people.apache.org/~jsdelfino/w
iki/screencaps/linux/runhelloworld.jpg
= Downloading and installing Tomcat =
- Point your Web browser to http://apache.secsup.org/d
ist/tomcat/tomcat-5/v5.5.16/bin/apache-tomcat-5.5.16.tar.gz.
+ Point your Web browser to http://www.ibi
blio.org/pub/mirrors/apache/tomcat/tomcat-5/v5.5.16/bin/apac
he-tomcat-5.5.16.tar.gz.
- Download apache-tomcat-5.5.16.tar.gz to the tuscany
directory.
+ Download apache-tomcat-5.5.16.tar.gz to the ~/tuscany
directory.
To install Tomcat, from the shell prompt do the following:
{{{
- cd $HOME/tuscany
+ cd ~/tuscany
tar xzvf apache-tomcat-5.5.16.tar.gz
}}}
- This will extract Tomcat to tuscany/apache-tomcat-5.5.16.
+ This will extract Tomcat to the
~/tuscany/apache-tomcat-5.5.16 directory.
From the shell prompt do the following:
{{{
- ant -f java/testing/tomcat/build.xml
-Dtuscany.acceptance.tc.dir=$HOME/tuscany/apache-tomcat-5.5.
16 tuscany.tomcat.fixup
+ ant -f java/testing/tomcat/build.xml
-Dtuscany.acceptance.tc.dir=~/tuscany/apache-tomcat-5.5.16
tuscany.tomcat.fixup
}}}
- This will configure Tomcat to use Tuscany and will install
the Tuscany JARs under the Tomcat lib directory. You should
see the following:
+ This will configure Tomcat to use Tuscany and will install
all the required JARs under the Tomcat lib directory.
+
+ You should see the following:
http://people.apache.org/~jsdelfino/wik
i/screencaps/linux/tomcatsetup.jpg
-223,
+228
cp
java/samples/helloworld/helloworldweb/target/helloworldWeb-S
NAPSHOT.war apache-tomcat-5.5.16/webapps
}}}
This will install the Hello``World``Web sample Web
application.
+
+ To start Tomcat do the following:
{{{
apache-tomcat-5.5.16/bin/startup.sh
}}}
- This will start Tomcat. You should see the following:
+ This will start Tomcat as a daemon process. You should see
the following:
http://people.apache.org/~jsdelfino/wik
i/screencaps/linux/starttomcat.jpg
- Point your Web browser to http://localhost:8080, you
should see the following:
+
+ To verify that Tomcat is running, point your Web browser
to http://localhost:8080.
+
+ You should see the Tomcat home page:
http://people.apache.org/~jsdelfino/wiki
/screencaps/linux/tomcathome.jpg
+
- To run the Hello``World``Web sample Web application, point
your Web browser to http://l
ocalhost:8080/helloworldWeb-SNAPSHOT, you should see the
following:
+ To run the Hello``World``Web sample Web application, point
your Web browser to http://
localhost:8080/helloworldWeb-SNAPSHOT.
+
+ You should see the following:
http://people.apache.org/~jsdelfino/w
iki/screencaps/linux/helloworldweb.jpg
+
- Click the Submit button, this will execute the sample
Hello``World SCA service. You should see the following:
+ Click the Submit button, this will execute the sample
Hello``World SCA service.
+
+ You should see the following:
http://people.apache.org/~jsdel
fino/wiki/screencaps/linux/helloworldwebsubmit.jpg
+
To stop Tomcat, from the shell prompt do the following:
{{{
apache-tomcat-5.5.16/bin/shutdown.sh
}}}
- This will stop Tomcat, you should see the following:
- http://people.apache.org/~jsdelfino/wiki
/screencaps/linux/stoptomcat.jpg
-
|
