You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@oozie.apache.org by rk...@apache.org on 2013/03/20 18:35:20 UTC

svn commit: r1458968 - in /oozie/trunk: docs/src/site/twiki/DG_QuickStart.twiki docs/src/site/twiki/ENG_Building.twiki release-log.txt

Author: rkanter
Date: Wed Mar 20 17:35:20 2013
New Revision: 1458968

URL: http://svn.apache.org/r1458968
Log:
OOZIE-1132 update quick start docs with build instructions (rkanter)

Modified:
    oozie/trunk/docs/src/site/twiki/DG_QuickStart.twiki
    oozie/trunk/docs/src/site/twiki/ENG_Building.twiki
    oozie/trunk/release-log.txt

Modified: oozie/trunk/docs/src/site/twiki/DG_QuickStart.twiki
URL: http://svn.apache.org/viewvc/oozie/trunk/docs/src/site/twiki/DG_QuickStart.twiki?rev=1458968&r1=1458967&r2=1458968&view=diff
==============================================================================
--- oozie/trunk/docs/src/site/twiki/DG_QuickStart.twiki (original)
+++ oozie/trunk/docs/src/site/twiki/DG_QuickStart.twiki Wed Mar 20 17:35:20 2013
@@ -8,7 +8,47 @@ These instructions install and run Oozie
 
 For detailed install and configuration instructions refer to [[AG_Install][Oozie Install]].
 
----++ System Requirements
+%TOC%
+
+---++ Building Oozie
+
+---+++ System Requirements:
+   * Unix box (tested on Mac OS X and Linux)
+   * Java JDK 1.6+
+   * Maven 3.0.1+
+   * Hadoop 0.20.2+
+   * Pig 0.7+
+
+JDK commands (java, javac) must be in the command path.
+
+The Maven command (mvn) must be in the command path.
+
+---+++ Building Oozie
+
+Download a source distribution of Oozie from the "Releases" drop down menu on the [[http://oozie.apache.org][Oozie site]].
+
+Expand the source distribution =tar.gz= and change directories into it.
+
+The simplest way to build Oozie is to run the =mkdistro.sh= script:
+<verbatim>
+$ bin/mkdistro.sh
+</verbatim>
+
+If you'd like to skip all of the tests, which can take some time:
+<verbatim>
+$ bin/mkdistro.sh -DskipTests
+</verbatim>
+Running =mkdistro.sh= will create the binary distribution of Oozie.
+
+*IMPORTANT:* By default it builds against Hadoop 1.1.1. It's possible to build against Hadoop 2.x versions as well, but it is
+strongly recommend to use a [[http://bigtop.apache.org][Bigtop]] distribution if using Hadoop 2.x because the Oozie sharelibs built
+from the tarball distribution will not work with it.
+
+More details on building Oozie can be found on the [[ENG_Building][Building Oozie]] page.
+
+---++ Server Installation
+
+---+++ System Requirements
 
    * Unix (tested in Linux and Mac OS X)
    * Java 1.6+
@@ -19,11 +59,11 @@ For detailed install and configuration i
 
 The Java 1.6+ =bin= directory should be in the command path.
 
----++ Server Installation
+---+++ Server Installation
 
 *IMPORTANT:* Oozie ignores any set value for =OOZIE_HOME=, Oozie computes its home automatically.
 
-   * Download or build an Oozie binary distribution
+   * Build an Oozie binary distribution
    * Download a Hadoop binary distribution
    * Download ExtJS library (it must be version 2.2)
 
@@ -142,6 +182,15 @@ Refer to the [[DG_Examples][Running the 
 
 ---++ Client Installation
 
+---+++ System Requirements
+
+   * Unix (tested in Linux and Mac OS X)
+   * Java 1.6+
+
+The Java 1.6+ =bin= directory should be in the command path.
+
+---+++ Client Installation
+
 Copy and expand the =oozie-client= TAR.GZ file bundled with the distribution. Add the =bin/= directory to the =PATH=.
 
 Refer to the [[DG_CommandLineTool][Command Line Interface Utilities]] document for a a full reference of the =oozie=

Modified: oozie/trunk/docs/src/site/twiki/ENG_Building.twiki
URL: http://svn.apache.org/viewvc/oozie/trunk/docs/src/site/twiki/ENG_Building.twiki?rev=1458968&r1=1458967&r2=1458968&view=diff
==============================================================================
--- oozie/trunk/docs/src/site/twiki/ENG_Building.twiki (original)
+++ oozie/trunk/docs/src/site/twiki/ENG_Building.twiki Wed Mar 20 17:35:20 2013
@@ -235,6 +235,8 @@ If none of these parameters are specifie
    * -Dhadoop.auth.version		: *2.0.0-alpha*
    * -Dpig.version				: *0.9.0*
 
+*IMPORTANT:* It is strongly recommend to use a [[http://bigtop.apache.org][Bigtop]] distribution if using Hadoop 2.x because the
+Oozie sharelibs built from the tarball distribution will not work with it.
 
 The following properties should be specified when building a release:
 

Modified: oozie/trunk/release-log.txt
URL: http://svn.apache.org/viewvc/oozie/trunk/release-log.txt?rev=1458968&r1=1458967&r2=1458968&view=diff
==============================================================================
--- oozie/trunk/release-log.txt (original)
+++ oozie/trunk/release-log.txt Wed Mar 20 17:35:20 2013
@@ -77,6 +77,7 @@ OOZIE-944 Implement Workflow Generator U
 
 -- Oozie 3.3.2 (unreleased)
 
+OOZIE-1132 update quick start docs with build instructions (rkanter)
 OOZIE-1268 Configuring Oozie to use SSL doesn't work if addtowar.sh is invoked directly (rkanter)
 OOZIE-1208 Oozie web-console when displaying Coord Job Log for an action gives Format Error (rohini via mona)
 OOZIE-1233 Add ability to configure Oozie to use HTTPS (SSL) (rkanter)