Apache Spark - A unified analytics engine for large-scale data processing
Go to file
Matei Zaharia 379648630b Merge pull request #805 from woggle/hadoop-rdd-jobconf
Use new Configuration() instead of slower new JobConf() in SerializableWritable
2013-08-11 14:51:47 -07:00
assembly SPARK-842. Maven assembly is including examples libs and dependencies 2013-07-31 17:26:55 -07:00
bagel Add Apache license headers and LICENSE and NOTICE files 2013-07-16 17:21:33 -07:00
bin Log the launch command for Spark daemons 2013-08-02 16:58:19 -07:00
conf add comment in spark-env.sh.template for SPARK_JAVA_OPTS 2013-08-09 15:03:48 +08:00
core Merge pull request #805 from woggle/hadoop-rdd-jobconf 2013-08-11 14:51:47 -07:00
docs Merge pull request #787 from ash211/master 2013-08-06 17:09:50 -07:00
ec2 Open up Job UI ports (33000-33010) on EC2 clusters 2013-07-29 17:19:33 -07:00
examples Merge pull request #762 from shivaram/sgd-cleanup 2013-08-11 10:52:55 -07:00
mllib Merge pull request #762 from shivaram/sgd-cleanup 2013-08-11 10:52:55 -07:00
project Merge pull request #800 from dlyubimov/HBASE_VERSION 2013-08-09 21:53:45 -07:00
python Merge pull request #747 from mateiz/improved-lr 2013-08-06 23:25:03 -07:00
repl Format cleanup. 2013-07-30 17:01:00 -07:00
repl-bin Consistently invoke bash with /usr/bin/env bash in scripts to make code more portable (JIRA Ticket SPARK-817) 2013-07-18 00:51:18 +00:00
sbt Merge pull request #714 from adatao/master 2013-07-18 11:43:48 -07:00
streaming Changed other LZF uses to use the compression codec interface. 2013-07-31 10:32:13 -07:00
tools Added missing scalatest dependency 2013-07-26 16:10:20 -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 Added property 'spark.executor.uri' for launching on Mesos without 2013-07-29 23:32:52 -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 Update to Chill 0.3.1 2013-08-08 13:30:27 -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.