diff options
Diffstat (limited to '')
-rw-r--r-- | sca-java-1.x/tags/travelsample-1.0/distribution/src/main/release/BUILDING | 139 |
1 files changed, 139 insertions, 0 deletions
diff --git a/sca-java-1.x/tags/travelsample-1.0/distribution/src/main/release/BUILDING b/sca-java-1.x/tags/travelsample-1.0/distribution/src/main/release/BUILDING new file mode 100644 index 0000000000..e5eabe3b88 --- /dev/null +++ b/sca-java-1.x/tags/travelsample-1.0/distribution/src/main/release/BUILDING @@ -0,0 +1,139 @@ +Building the Apache Tuscany SCA Travel Sample 1.0 June 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.
+
+
+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.
+
+
+Changing the Tuscany SCA Java version used for the build
+--------------------------------------------------------
+
+If you are using Maven to build the travel sample, the maven build files
+are set up to use the 1.6 version of Tuscany SCA Java. You can build
+the travel sample using some other version of Tuscany SCA Java (for example,
+a development snapshot) by changing the <tuscany.version> property in the
+travelsample/pom.xml file.
+
+If you are using Ant to build the travel sample, you can change the
+version of Tuscany SCA Java used by the build by changing the setting of
+the TUSCANY_HOME environment variable before running the build.
+
+
+Building a development snaphost of the travel sample code
+---------------------------------------------------------
+
+You can build the latest development snapshot of the travel sample by
+following these steps:
+
+1) Install Apache Subversion 1.4.0 or later, which can be downloaded from
+http://subversion.apache.org/packages.html. Make sure that your PATH
+includes the "bin" subdirectory of the installation base directory.
+
+2) Check out the travel sample code from svn using the following command:
+svn co http://svn.apache.org/repos/asf/tuscany/sca-java-1.x/trunk/tutorials/travelsample
+
+3) Change to the travelsample directory of your local travel sample checkout
+and run the command "mvn". This will use Maven to compile the complete
+travel sample and run all of the travel sample unit tests.
+
+4) If you want to build the travel sample using Ant instead of Maven,
+you need to peform the following additional steps:
+
+ 4a) 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.
+
+ 4b) 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.
+
+ 4c) 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.
+
+ 4d) Change to the travelsample directory of your local travel sample
+ checkout and run the command "ant". This will use Ant to compile the
+ complete travel sample and run all of the travel sample unit tests.
|