Commits

Jason Baldridge committed a3f3c9b

Upped version, improved README. Made check for lib_managed in bin/fogbow.

Comments (0)

Files changed (3)

 Introduction
 ============
 
-This package provides example code for instruction for Hadoop. It is
-called "fogbow" because of the prevalent use of meteorological terms
-in cloud computing packages. (The word "fogbow" itself means a rainbow
-formed from fog rather than clouds.)
+This package provides example code for instruction for Hadoop. It
+provides a build structure that ensures that all the packages
+necessary for building basic Hadoop applications are available for
+compilation, and further, that they are available for running
+applications using a pre-configured classpath or bottleds-up assembly
+jar that contains Fogbow and all its dependencies. 
+
+The toolkit is called Fogbow because of the prevalent use of
+meteorological terms in cloud computing packages. (The word "fogbow"
+itself means a rainbow formed from fog rather than clouds.)
+
+There are just two classes in Fogbow.
 
  * fogbow.example.WordCount - word count in Java (from the
    standard Hadoop distribution)
 * Version 1.6 of the Java 2 SDK (http://java.sun.com)
 * Version 0.20.2 of Hadoop: http://hadoop.apache.org/common/releases.html
 
+
 Configuring your environment variables
 ======================================
 
 Next, add the directory FOGBOW_DIR/bin to your path. For example, you
 can set the path in your .bashrc file as follows:
 
-export PATH="$PATH:$FOGBOW_DIR/bin"
+export PATH=$PATH:$FOGBOW_DIR/bin
 
 Once you have taken care of these three things, you should be able to
 build and use the Fogbow Library.
 the value when on Unix, but you must *NOT* do this when under Windows.
 
 It is assumed that you have Hadoop 0.20.2 installed and in your path,
-and that you have set HADOOP_DIR to be the location of your Hadoop
+and that you have set HADOOP_HOME to be the location of your Hadoop
 0.20.2 installation.
 
 
 https://github.com/harrah/xsbt/wiki
 
 Note: if you have SBT 0.10.1 already installed on your system, you can
-also just call it directly with "sbt".
+also just call it directly with "sbt" in FOGBOW_DIR.
 
 
 Trying it out
 build to your own project and start creating your own packages based
 on these fairly straightforwardly. You'll want to:
 
- * change the information in $FOGBOW_DIR/project/build.properties to
-   reflect your own project details
+ * Change $FOGBOW_DIR/build.sbt properties and configurations to be
+   appropriate for your project. If you need to specify new managed
+   dependencies, you can do so easily in that file (see SBT
+   documentation for details). If you prefer to add dependencies
+   manually, just add them to $FOGBOW_DIR/lib and they'll get picked
+   up without any fuss.
 
- * change $FOGBOW_DIR/build.sbt configurations to be appropriate for
-   your project, and if you need to specify new managed dependencies,
-   you can do so easily in that file (see SBT documentation for
-   details). If you prefer to add dependencies manually, just add them
-   to $FOGBOW_DIR/lib and they'll get picked up without any fuss.
-
- * change $FOGBOW_DIR/bin to be an executable of your choice, named
+ * Change $FOGBOW_DIR/bin to be an executable of your choice, named
    for your project, and adapt as necessary (including changing
    $FOGBOW to your project name, etc).
 
 =========================
 
 Email Jason Baldridge: jasonbaldrige@gmail.com
+
+Or, create an issue on Bitbucket: 
+
+    https://bitbucket.org/jasonbaldridge/fogbow/issues
+
 #!/bin/bash
 
-if [ -z $HADOOP_DIR ]
+JARS=`echo $FOGBOW_DIR/lib/*.jar $FOGBOW_DIR/target/*.jar $HADOOP_HOME/*.jar $HADOOP_HOME/lib/*.jar | tr ' ' ':'`
+
+JARS_MANAGED=
+if [ -e $FOGBOW_DIR/lib_managed ]
 then
-    HADOOP_DIR=$HADOOP_HOME
+    JARS_MANAGED=`find $FOGBOW_DIR/lib_managed -name '*.jar' -print | tr '\n' ':'`
 fi
 
-JARS=`echo $FOGBOW_DIR/lib/*.jar $FOGBOW_DIR/target/*.jar $HADOOP_DIR/*.jar $HADOOP_DIR/lib/*.jar | tr ' ' ':'`
-JARS_MANAGED=`find $FOGBOW_DIR/lib_managed -name '*.jar' -print | tr '\n' ':'`
-
 SCALA_LIB="$FOGBOW_DIR/project/boot/scala-2.9.0/lib/scala-library.jar"
 
 CP=$FOGBOW_DIR/target/classes:$JARS:$JARS_MANAGED:$SCALA_LIB:$CLASSPATH
 help()
 {
 cat <<EOF
-Fogbow 0.1 commands: 
+Fogbow 0.1.2 commands: 
 
   build         build Fogbow with SBT
   wordcount     do the standard word count example
 name := "Fogbow"
 
-version := "0.1"
+version := "0.1.2"
 
 organization := "The University of Texas at Austin"