Apache Spark - A unified analytics engine for large-scale data processing
Go to file
Matei Zaharia af74217c96 Undo JLine fix that turns out to only be needed when buildr is running
on JRuby. This is quite ugly: JRuby has its own version of JLine which
is older than Scala's, and JLine changed API in such a way that code
written for the new version won't compile with the old one and vice
versa. Sadly, this might be a reason to drop buildr, unless we can
package a JRuby with it that uses the right version, or we ask people to
only use the C Ruby version of buildr (which doesn't work on OS X right
now!)
2010-11-13 18:38:50 -08:00
conf Undid some changes that Mosharaf inadvertedly committed to master. 2010-10-19 13:58:52 -07:00
src Undo JLine fix that turns out to only be needed when buildr is running 2010-11-13 18:38:50 -08:00
third_party Merge branch 'master' of git@github.com:mesos/spark 2010-10-18 11:08:45 -07:00
.gitignore Modified project structure to work with buildr 2010-11-13 17:18:05 -08:00
alltests Modified project structure to work with buildr 2010-11-13 17:18:05 -08:00
buildfile Undo JLine fix that turns out to only be needed when buildr is running 2010-11-13 18:38:50 -08:00
lr_data.txt Initial commit 2010-03-29 16:17:55 -07:00
Makefile Less hacky way of preventing config files from being overwritten when a template file changes 2010-10-16 22:01:05 -07:00
README Improved README and added blank templates for config files. 2010-08-13 18:54:32 -07:00
run Modified project structure to work with buildr 2010-11-13 17:18:05 -08:00
spark-executor Made spark-executor output slightly nicer 2010-09-29 00:22:09 -07:00
spark-shell Initial commit 2010-03-29 16:17:55 -07:00

BUILDING

Spark requires Scala 2.8. This version has been tested with 2.8.0.final.

To build and run Spark, you will need to have Scala's bin in your $PATH,
or you will need to set the SCALA_HOME environment variable to point
to where you've installed Scala. Scala must be accessible through one
of these methods on Mesos slave nodes as well as on the master.

To build Spark and the example programs, run make.

To run one of the examples, use ./run <class> <params>. For example,
./run SparkLR will run the Logistic Regression example. Each of the
example programs prints usage help if no params are given.

All of the Spark samples take a <host> parameter that is the Mesos master
to connect to. This can be a Mesos URL, or "local" to run locally with one
thread, or "local[N]" to run locally with N threads.

Tip: If you are building Spark and examples repeatedly, export USE_FSC=1
to have the Makefile use the fsc compiler daemon instead of scalac.

CONFIGURATION

Spark can be configured through two files: conf/java-opts and conf/spark-env.sh.

In java-opts, you can add flags to be passed to the JVM when running Spark.

In spark-env.sh, you can set any environment variables you wish to be available
when running Spark programs, such as PATH, SCALA_HOME, etc. There are also
several Spark-specific variables you can set:
- SPARK_CLASSPATH: Extra entries to be added to the classpath, separated by ":".
- SPARK_MEM: Memory for Spark to use, in the format used by java's -Xmx option
             (for example, 200m meams 200 MB, 1g means 1 GB, etc).
- SPARK_LIBRARY_PATH: Extra entries to add to java.library.path for locating
                      shared libraries.
- SPARK_JAVA_OPTS: Extra options to pass to JVM.

Note that spark-env.sh must be a shell script (it must be executable and start
with a #! header to specify the shell to use).