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: http://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://java.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 http://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-SNAPSHOT.jar + ~/.m2/repository/org/osoa/sca-api/SNAPSHOT/sca-api-SNAPSHOT.jar - $HOME/.m2/repository/org/apache/tuscany/tuscany-common/SNAPSHOT/tuscany-common-SNAPSHOT.jar + ~/.m2/repository/org/apache/tuscany/tuscany-common/SNAPSHOT/tuscany-common-SNAPSHOT.jar - $HOME/.m2/repository/org/apache/tuscany/tuscany-core/SNAPSHOT/tuscany-core-SNAPSHOT.jar + ~/.m2/repository/org/apache/tuscany/tuscany-core/SNAPSHOT/tuscany-core-SNAPSHOT.jar - $HOME/.m2/repository/org/apache/tuscany/tuscany-model/SNAPSHOT/tuscany-model-SNAPSHOT.jar + ~/.m2/repository/org/apache/tuscany/tuscany-model/SNAPSHOT/tuscany-model-SNAPSHOT.jar - $HOME/.m2/repository/axis/axis-wsdl4j/1.2/axis-wsdl4j-1.2.jar + ~/.m2/repository/axis/axis-wsdl4j/1.2/axis-wsdl4j-1.2.jar - $HOME/.m2/repository/commonj/sdo-api/SNAPSHOT/sdo-api-SNAPSHOT.jar + ~/.m2/repository/commonj/sdo-api/SNAPSHOT/sdo-api-SNAPSHOT.jar - $HOME/.m2/repository/org/apache/tuscany/tuscany-sdo-impl/SNAPSHOT/tuscany-sdo-impl-SNAPSHOT.jar + ~/.m2/repository/org/apache/tuscany/tuscany-sdo-impl/SNAPSHOT/tuscany-sdo-impl-SNAPSHOT.jar - $HOME/.m2/repository/org/eclipse/emf/ecore/2.2.0-SNAPSHOT/ecore-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/common-2.2.0-SNAPSHOT.jar + ~/.m2/repository/org/eclipse/emf/common/2.2.0-SNAPSHOT/common-2.2.0-SNAPSHOT.jar - $HOME/.m2/repository/org/eclipse/emf/ecore-change/2.2.0-SNAPSHOT/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/tuscany-container-java/SNAPSHOT/tuscany-container-java-SNAPSHOT.jar + ~/.m2/repository/org/apache/tuscany/sca/containers/tuscany-container-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/wiki/screencaps/linux/runhelloworld.jpg = Downloading and installing Tomcat = - Point your Web browser to http://apache.secsup.org/dist/tomcat/tomcat-5/v5.5.16/bin/apache-tomcat-5.5.16.tar.gz. + Point your Web browser to http://www.ibiblio.org/pub/mirrors/apache/tomcat/tomcat-5/v5.5.16/bin/apache-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/wiki/screencaps/linux/tomcatsetup.jpg @@ -223, +228 @@ cp java/samples/helloworld/helloworldweb/target/helloworldWeb-SNAPSHOT.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/wiki/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://localhost: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/wiki/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/~jsdelfino/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 -
