archive/apache-tuscany
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add BUILDING, CHANGES and RELEASE_NOTES files

Browse source 
git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@936083 13f79535-47bb-0310-9956-ffa450edef68
This commit is contained in:
nash 2010-04-20 22:09:20 +00:00
parent 622e1f751d
commit 33eb68678d
3 changed files with 178 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

111
sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/BUILDING Normal file
View file

@ -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 <tuscany.version> 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.

4
sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/CHANGES Normal file
View file

@ -0,0 +1,4 @@
Changes in Apache Tuscany SCA Travel Sample 1.0 April 2010
==========================================================
First release of the travel sample.

63
sca-java-1.x/trunk/tutorials/travelsample/distribution/src/main/release/RELEASE_NOTES Normal file
View file

@ -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.