From 33eb68678df85f393fe2c60d815c27b9347d3da1 Mon Sep 17 00:00:00 2001 From: nash Date: Tue, 20 Apr 2010 22:09:20 +0000 Subject: Add BUILDING, CHANGES and RELEASE_NOTES files git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@936083 13f79535-47bb-0310-9956-ffa450edef68 --- .../distribution/src/main/release/BUILDING | 111 +++++++++++++++++++++ .../distribution/src/main/release/CHANGES | 4 + .../distribution/src/main/release/RELEASE_NOTES | 63 ++++++++++++ 3 files changed, 178 insertions(+) create mode 100644 sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/BUILDING create mode 100644 sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/CHANGES create mode 100644 sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/RELEASE_NOTES (limited to 'sca-java-1.x/trunk/tutorials') diff --git a/sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/BUILDING b/sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/BUILDING new file mode 100644 index 0000000000..8600064227 --- /dev/null +++ b/sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/BUILDING @@ -0,0 +1,111 @@ +Building the Apache Tuscany SCA Travel Sample 1.0 April 2010 release distribution +================================================================================= + +Initial Setup +------------- + +1) Install Java SE JDK 5 or JDK 6, which can be downloaded from + http://java.sun.com/javase/downloads/index.jsp. For JDK 5 use update 22 + and for JDK 6 use update 7 (or later). + +2) Make sure that your JAVA_HOME environment variable is set to the newly installed + JDK location, and that your PATH includes %JAVA_HOME%\bin (windows) or + $JAVA_HOME/bin (unix). + +3) Install Apache Maven 2.0.7 or later, which can be downloaded from + http://maven.apache.org/download.html. Make sure that your M2_HOME + environment variable is set to the installation base directory, and that + your PATH includes %M2_HOME%\bin (windows) or $M2_HOME/bin (unix). + +4) Install Apache Ant 1.7.1 or later, which can be downloaded from + http://ant.apache.org/bindownload.cgi. Make sure that your ANT_HOME + environment variable is set to the installation base directory, and that + your PATH includes %ANT_HOME%\bin (windows) or $ANT_HOME/bin (unix). + +5) Download the Apache Tuscany SCA Java 1.6 (or later) binary distribution + from http://tuscany.apache.org/sca-java-1x-releases.html and unpack it + into a local directory. Set your TUSCANY_HOME environment variable to + the base directory containing the unpacked binary distribution. + +6) Download the Apache Tuscany SCA Java Travel Sample 1.0 (or later) distribution + from http://tuscany.apache.org/sca-java-travel-sample-1x-releases.html and + unpack it into a local directory. + +The following steps are only needed if you will be using Maven to build the +travel sample: + + 7) Check the setting of the property in the + travelsample/pom.xml file. If you want to build the travel sample using + a different Tuscany version, change this property as necessary. The + travel sample has been tested and runs correctly with Tuscany SCA Java 1.6. + +The following steps are only needed if you will be using Ant to build the +travel sample: + + 8) Download the Apache OpenEJB 3.1.2 (or later) binary distribution from + http://openejb.apache.org/download.html and unpack it into a local + directory. Set your OPENEJB_HOME environment variable to the base directory + containing the unpacked binary distribution. + + 9) If you are using JDK 5, download the JAX-WS reference implementation + version 2.1.7 from https://jax-ws.dev.java.net/2.1.7/ and unpack it into + a local directory. Set your JAXWS_HOME environment variable to the base + directory containing the unpacked download. + +10) Download the JUnit 4.5 (or later) binary distribution from + http://github.com/KentBeck/junit/downloads and unpack it into a local + directory. Set your the JUNIT_JAR environment variable to the full path + to the junit-x.y.z.jar in the unpacked binary distribution taking care + to replace x.y.z with the JUnit version number. + + +Building using Ant +------------------ + +1) Change to the "travelsample" directory of the Apache Tuscany SCA Travel Sample + distribution which you unpacked in step 6) above. + +2) Run the command "ant". This will compile the complete travel sample and + run all of the travel sample unit tests. + + +Building using Maven +-------------------- + +1) Change to the "travelsample" directory of the Apache Tuscany SCA Travel Sample + distribution which you unpacked in step 6) above. + +2) Run the command "mvn". You will need a live internet connection so that + Maven can download any required files to your local repository. This will + compile the complete travel sample and run all of the travel sample unit tests. + + Depending on the load of remote Maven 2.0 repositories, you may have + to run "mvn" several times until the required dependencies are + all located in your local maven repository. It usually takes some time for + maven to download required dependencies in the first build. Once all the + dependencies have been downloaded you may use the -o option to run maven + in offline mode, for example, 'mvn clean install -o'. + + When building with Maven, an executable binary package for the travel + sample is created in the travelsample/binaries/target directory. By default + this binary package is an add-on delta to the Tuscany SCA Java 1.6 binary + distribution. If you want to produce a fully self-contained binary package + in the travelsample/binaries/target directory (with no external dependencies), + you can use the command "mvn -Pselfcontained" instead of "mvn" when + building from the "travelsample" directory. + + +Building the Distribution +------------------------- + +1) Change to the travelsample/distribution directory. + +2) Run the command "mvn". This will build the distribution package + with .zip and .tar.gz formats in the distribution/target directory. + + +Running the Travel Sample +------------------------- + +Full details of how to run the travel sample can be found in the README +file in the "travelsample" directory of the unpacked distribution. diff --git a/sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/CHANGES b/sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/CHANGES new file mode 100644 index 0000000000..8175ae30fc --- /dev/null +++ b/sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/CHANGES @@ -0,0 +1,4 @@ +Changes in Apache Tuscany SCA Travel Sample 1.0 April 2010 +========================================================== + +First release of the travel sample. diff --git a/sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/RELEASE_NOTES b/sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/RELEASE_NOTES new file mode 100644 index 0000000000..ff0375f7d3 --- /dev/null +++ b/sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/RELEASE_NOTES @@ -0,0 +1,63 @@ +Apache Tuscany SCA Travel Sample 1.0 April 2010 Release Notes +============================================================= + +The Apache Tuscany SCA Travel Sample shows how Apache Tuscany SCA +can be used in a business application. + +Overview +-------- + +The travel sample consists of a number of scenarios which demonstrate +various aspects of SCA and Apache Tuscany in the context of a travel +booking application. Details of these scenarios can be found in the +travel sample README file. + +Unlike other Apache Tuscany SCA samples that are included in the +Apache Tuscany SCA distribution, the travel sample is released as a +separate package. This matches how user applications are developed +and makes it easier for Apache Tuscany users to use the travel sample +as a template for developing and packaging their own applications. + +The travel sample distribution contains source code and build files. +It doesn't contain binaries because one of the major purposes of this +sample is to show users how to build and run an Apache Tuscany +application from source code. The travel sample BUILDING file gives +details of the steps needed to do this. + +See the travel sample CHANGES file for a detailed list of new features +and bug fixes in this release. + +Support +------- + +For more information on Apache Tuscany visit the website at: + + http://tuscany.apache.org/ + +Any issues with this release can be reported to Apache Tuscany +using the mailing lists or in the JIRA issue tracker. + + Mailing list archives: + + http://mail-archives.apache.org/mod_mbox/tuscany-user + http://mail-archives.apache.org/mod_mbox/tuscany-dev/ + + JIRA: + + http://issues.apache.org/jira/browse/TUSCANY + +To join the project's mailing lists follow the instructions at: + + http://tuscany.apache.org/mailing-lists.html + +To find out more about OASIS Open CSA go to: + + http://www.oasis-opencsa.org. + +Apache Tuscany welcomes your help. Any contribution, including code, +testing, improving the documentation, or bug reporting is always +appreciated. + +Thank you for using Apache Tuscany! + +- The Tuscany Team. -- cgit v1.2.3