Apache Spark - A unified analytics engine for large-scale data processing
Go to file
2013-08-20 16:13:36 -07:00
assembly Forgot to remove a few references to ${classifier} 2013-08-16 13:50:12 -07:00
bagel Remove redundant dependencies from POMs 2013-08-18 18:53:57 -07:00
bin Don't assume spark-examples JAR always exists 2013-08-18 16:59:02 -07:00
conf fixing typo 2013-08-15 20:52:58 -06:00
core Bug, should compute slack wrt parent partition size, not number of bins 2013-08-20 16:13:36 -07:00
docs Merge remote-tracking branch 'jey/hadoop-agnostic' 2013-08-20 10:14:15 -07:00
ec2 Allow some wiggle room in UISuite port test and in EC2 ports 2013-08-19 18:51:00 -07:00
examples Remove redundant dependencies from POMs 2013-08-18 18:53:57 -07:00
mllib Remove redundant dependencies from POMs 2013-08-18 18:53:57 -07:00
project Merge remote-tracking branch 'jey/hadoop-agnostic' 2013-08-20 10:14:15 -07:00
python Implementing SPARK-878 for PySpark: adding zip and egg files to context and passing it down to workers which add these to their sys.path 2013-08-16 11:58:20 -07:00
repl Remove redundant dependencies from POMs 2013-08-18 18:53:57 -07:00
repl-bin Remove redundant dependencies from POMs 2013-08-18 18:53:57 -07:00
sbt Merge pull request #714 from adatao/master 2013-07-18 11:43:48 -07:00
streaming Remove redundant dependencies from POMs 2013-08-18 18:53:57 -07:00
tools Merge remote-tracking branch 'jey/hadoop-agnostic' 2013-08-20 10:14:15 -07:00
yarn Merge remote-tracking branch 'jey/hadoop-agnostic' 2013-08-20 10:14:15 -07:00
.gitignore adding files generated from make-distribution.sh to .gitignore 2013-07-15 19:13:39 -06:00
kmeans_data.txt Fixed bugs 2012-01-09 11:59:52 -08:00
LICENSE Add Apache license headers and LICENSE and NOTICE files 2013-07-16 17:21:33 -07:00
lr_data.txt Test commit 2012-02-06 09:58:06 -08:00
make-distribution.sh Rename YARN build flag to SPARK_WITH_YARN 2013-08-16 14:00:05 -07:00
NOTICE Add Apache license headers and LICENSE and NOTICE files 2013-07-16 17:21:33 -07:00
pagerank_data.txt Add a sample data file for PageRank 2013-08-10 18:13:49 -07:00
pom.xml Merge remote-tracking branch 'jey/hadoop-agnostic' 2013-08-20 10:14:15 -07:00
pyspark Two fixes to IPython support: 2013-07-28 22:23:13 -04:00
README.md Updating README to reflect Scala 2.9.3 requirements 2013-07-10 22:16:06 -07:00
run Make output formatting consistent between bash/scala 2013-08-03 21:30:15 -07:00
run.cmd Add Apache license headers and LICENSE and NOTICE files 2013-07-16 17:21:33 -07:00
run2.cmd Add Apache license headers and LICENSE and NOTICE files 2013-07-16 17:21:33 -07:00
spark-executor Add Apache license headers and LICENSE and NOTICE files 2013-07-16 17:21:33 -07:00
spark-shell Building spark assembly for further consumption of the Spark project with a deployed cluster 2013-07-21 11:47:29 -07:00
spark-shell.cmd Add Apache license headers and LICENSE and NOTICE files 2013-07-16 17:21:33 -07:00

Spark

Lightning-Fast Cluster Computing - http://www.spark-project.org/

Online Documentation

You can find the latest Spark documentation, including a programming guide, on the project webpage at http://spark-project.org/documentation.html. This README file only contains basic setup instructions.

Building

Spark requires Scala 2.9.3 (Scala 2.10 is not yet supported). The project is built using Simple Build Tool (SBT), which is packaged with it. To build Spark and its example programs, run:

sbt/sbt package

Spark also supports building using Maven. If you would like to build using Maven, see the instructions for building Spark with Maven in the spark documentation..

To run Spark, you will need to have Scala's bin directory 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 your cluster's worker nodes as well as its master.

To run one of the examples, use ./run <class> <params>. For example:

./run spark.examples.SparkLR local[2]

will run the Logistic Regression example locally on 2 CPUs.

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 cluster URL to connect to. This can be a mesos:// or spark:// URL, or "local" to run locally with one thread, or "local[N]" to run locally with N threads.

A Note About Hadoop Versions

Spark uses the Hadoop core library to talk to HDFS and other Hadoop-supported storage systems. Because the HDFS API has changed in different versions of Hadoop, you must build Spark against the same version that your cluster runs. You can change the version by setting the HADOOP_VERSION variable at the top of project/SparkBuild.scala, then rebuilding Spark.

Configuration

Please refer to the "Configuration" guide in the online documentation for a full overview on how to configure Spark. At the minimum, you will need to create a conf/spark-env.sh script (copy conf/spark-env.sh.template) and set the following two variables:

  • SCALA_HOME: Location where Scala is installed.

  • MESOS_NATIVE_LIBRARY: Your Mesos library (only needed if you want to run on Mesos). For example, this might be /usr/local/lib/libmesos.so on Linux.

Contributing to Spark

Contributions via GitHub pull requests are gladly accepted from their original author. Along with any pull requests, please state that the contribution is your original work and that you license the work to the project under the project's open source license. Whether or not you state this explicitly, by submitting any copyrighted material via pull request, email, or other means you agree to license the material under the project's open source license and warrant that you have the legal authority to do so.