#Zeppelin

**Documentation:** [User Guide](http://zeppelin.incubator.apache.org/docs/latest/index.html)<br/>

**Mailing Lists:** [User and Dev mailing list](http://zeppelin.incubator.apache.org/community.html)<br/>

**Continuous Integration:** [](https://travis-ci.org/apache/incubator-zeppelin) <br/>

**Contributing:** [Contribution Guide](https://github.com/apache/incubator-zeppelin/blob/master/CONTRIBUTING.md)<br/>

**Issue Tracker:** [Jira](https://issues.apache.org/jira/browse/ZEPPELIN)<br/>

**License:** [Apache 2.0](https://github.com/apache/incubator-zeppelin/blob/master/LICENSE)

**Zeppelin**, a web-based notebook that enables interactive data analytics. You can make beautiful data-driven, interactive and collaborative documents with SQL, Scala and more.

Core feature:

* Web based notebook style editor.

* Built-in Apache Spark support

* Java 1.7

* Tested on Mac OSX, Ubuntu 14.X, CentOS 6.X

* Maven (if you want to build from the source code)

* Node.js Package Manager

If you don't have requirements prepared, install it.

(The installation method may vary according to your environment, example is for Ubuntu.)

_Notes:_

- Ensure node is installed by running `node --version`

- Ensure maven is running version 3.1.x or higher with `mvn -version`

- Configure maven to use more memory than usual by ```export MAVEN_OPTS="-Xmx2g -XX:MaxPermSize=1024m"```

If you want to build Zeppelin from the source, please first clone this repository, then:

Each Interpreter requires different Options.

To build with a specific Spark version, Hadoop version or specific features, define one or more of the following profiles and options:

Set spark major version

Available profiles are

minor version can be adjusted by `-Dspark.version=x.x.x`

set hadoop major version

Available profiles are

minor version can be adjusted by `-Dhadoop.version=x.x.x`

enable 3rd party vendor repository (cloudera)

For the MapR Hadoop Distribution, these profiles will handle the Hadoop version. As MapR allows different versions

of Spark to be installed, you should specify which version of Spark is installed on the cluster by adding a Spark profile (-Pspark-1.2, -Pspark-1.3, etc.) as needed. For Hive, check the hive/pom.xml and adjust the version installed as well. The correct Maven

artifacts can be found for every version of MapR at http://doc.mapr.com

Available profiles are

Here're some examples:

If you wish to configure Zeppelin option (like port number), configure the following files:

(You can copy ```./conf/zeppelin-env.sh.template``` into ```./conf/zeppelin-env.sh```.

Same for ```zeppelin-site.xml```.)

Without SPARK_HOME and HADOOP_HOME, Zeppelin uses embedded Spark and Hadoop binaries that you have specified with mvn build option.

If you want to use system provided Spark and Hadoop, export SPARK_HOME and HADOOP_HOME in zeppelin-env.sh

You can use any supported version of spark without rebuilding Zeppelin.

Mesos

# ./conf/zeppelin-env.sh

export MASTER=mesos://...

export ZEPPELIN_JAVA_OPTS="-Dspark.executor.uri=/path/to/spark-*.tgz" or SPARK_HOME="/path/to/spark_home"

export MESOS_NATIVE_LIBRARY=/path/to/libmesos.so

If you set `SPARK_HOME`, you should deploy spark binary on the same location to all worker nodes. And if you set `spark.executor.uri`, every worker can read that file on its node.

Yarn

# ./conf/zeppelin-env.sh

export SPARK_HOME=/path/to/spark_dir

./bin/zeppelin-daemon.sh start

To package the final distribution including the compressed archive, run:

###Run end-to-end tests

Zeppelin comes with a set of end-to-end acceptance tests driving headless selenium browser

#assumes zeppelin-server running on localhost:8080 (use -Durl=.. to override)

mvn verify

#or take care of starting\stoping zeppelin-server from packaged _zeppelin-distribuion/target_

mvn verify -P using-packaged-distr