Build

Prerequisites

  • Java 1.7
  • None root account
  • Apache Maven

Build tested on OSX, CentOS 6.

Checkout source code from https://github.com/apache/incubator-zeppelin

Local mode

mvn install -DskipTests

Cluster mode

mvn install -DskipTests -Dspark.version=1.1.0 -Dhadoop.version=2.2.0

Change spark.version and hadoop.version to your cluster's one.

Custom built Spark

Note that is you uses custom build spark, you need build Zeppelin with custome built spark artifact. To do that, deploy spark artifact to local maven repository using

sbt/sbt publish-local

and then build Zeppelin with your custom built Spark

mvn install -DskipTests -Dspark.version=1.1.0-Custom -Dhadoop.version=2.2.0

Configure

Configuration can be done by both environment variable(conf/zeppelin-env.sh) and java properties(conf/zeppelin-site.xml). If both defined, environment vaiable is used.

zepplin-env.sh zepplin-site.xml Default value Description
ZEPPELIN_PORT zeppelin.server.port 8080 Zeppelin server port. Note that port+1 is used for web socket
ZEPPELIN_NOTEBOOK_DIR zeppelin.notebook.dir notebook Where notebook file is saved
ZEPPELIN_INTERPRETERS zeppelin.interpreters org.apache.zeppelin.spark.SparkInterpreter,
org.apache.zeppelin.spark.PySparkInterpreter,
org.apache.zeppelin.spark.SparkSqlInterpreter,
org.apache.zeppelin.spark.DepInterpreter,
org.apache.zeppelin.markdown.Markdown,
org.apache.zeppelin.shell.ShellInterpreter,
org.apache.zeppelin.hive.HiveInterpreter
Comma separated interpreter configurations [Class]. First interpreter become a default
ZEPPELIN_INTERPRETER_DIR zeppelin.interpreter.dir interpreter Zeppelin interpreter directory
MASTER N/A Spark master url. eg. spark://master_addr:7077. Leave empty if you want to use local mode
ZEPPELIN_JAVA_OPTS N/A JVM Options

Start/Stop

Start Zeppelin

bin/zeppelin-daemon.sh start

After successful start, visit http://localhost:8080 with your web browser. Note that port 8081 also need to be accessible for websocket connection.

Stop Zeppelin

bin/zeppelin-daemon.sh stop