Modified: zeppelin/site/docs/0.7.0-SNAPSHOT/rss.xml URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.0-SNAPSHOT/rss.xml?rev=1760292&r1=1760291&r2=1760292&view=diff ============================================================================== --- zeppelin/site/docs/0.7.0-SNAPSHOT/rss.xml (original) +++ zeppelin/site/docs/0.7.0-SNAPSHOT/rss.xml Mon Sep 12 04:31:10 2016 @@ -5,8 +5,8 @@ <description>Apache Zeppelin - The Apache Software Foundation</description> <link>http://zeppelin.apache.org</link> <link>http://zeppelin.apache.org</link> - <lastBuildDate>2016-08-24T18:41:55+02:00</lastBuildDate> - <pubDate>2016-08-24T18:41:55+02:00</pubDate> + <lastBuildDate>2016-09-12T06:27:44+02:00</lastBuildDate> + <pubDate>2016-09-12T06:27:44+02:00</pubDate> <ttl>1800</ttl>
Modified: zeppelin/site/docs/0.7.0-SNAPSHOT/screenshots.html URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.0-SNAPSHOT/screenshots.html?rev=1760292&r1=1760291&r2=1760292&view=diff ============================================================================== --- zeppelin/site/docs/0.7.0-SNAPSHOT/screenshots.html (original) +++ zeppelin/site/docs/0.7.0-SNAPSHOT/screenshots.html Mon Sep 12 04:31:10 2016 @@ -3,8 +3,8 @@ <html lang="en"> <head> <meta charset="utf-8"> - <title>Apache Zeppelin 0.7.0-SNAPSHOT Documentation: Screenshots</title> - <meta name="description" content=""> + <title>Apache Zeppelin 0.7.0-SNAPSHOT Documentation: </title> + <meta name="author" content="The Apache Software Foundation"> <!-- Enable responsive viewport --> @@ -152,6 +152,8 @@ <li class="title"><span><b>Advanced</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li> <li role="separator" class="divider"></li> <li class="title"><span><b>Contibute</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li> @@ -176,7 +178,7 @@ <div class="content"> -<!--<div class="hero-unit Screenshots"> +<!--<div class="hero-unit "> <h1></h1> </div> --> Modified: zeppelin/site/docs/0.7.0-SNAPSHOT/search.html URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.0-SNAPSHOT/search.html?rev=1760292&r1=1760291&r2=1760292&view=diff ============================================================================== --- zeppelin/site/docs/0.7.0-SNAPSHOT/search.html (original) +++ zeppelin/site/docs/0.7.0-SNAPSHOT/search.html Mon Sep 12 04:31:10 2016 @@ -152,6 +152,8 @@ <li class="title"><span><b>Advanced</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li> <li role="separator" class="divider"></li> <li class="title"><span><b>Contibute</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li> Modified: zeppelin/site/docs/0.7.0-SNAPSHOT/search_data.json URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.0-SNAPSHOT/search_data.json?rev=1760292&r1=1760291&r2=1760292&view=diff ============================================================================== --- zeppelin/site/docs/0.7.0-SNAPSHOT/search_data.json (original) +++ zeppelin/site/docs/0.7.0-SNAPSHOT/search_data.json Mon Sep 12 04:31:10 2016 @@ -4,7 +4,7 @@ "/atom.xml": { "title": "Atom Feed", - "content" : " Apache Zeppelin 2016-08-24T18:41:55+02:00 http://zeppelin.apache.org The Apache Software Foundation [email protected] ", + "content" : " Apache Zeppelin 2016-09-12T06:27:44+02:00 http://zeppelin.apache.org The Apache Software Foundation [email protected] ", "url": " /atom.xml", "group": "", "excerpt": "" @@ -48,7 +48,7 @@ "/development/writingzeppelininterpreter.html": { "title": "Writing a New Interpreter", - "content" : "<!--Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.-->Writing a New InterpreterWhat is Apache Zeppelin InterpreterApache Zeppelin Interpreter is a language backend. For example to use scala code in Zeppelin, you need a scala interpreter.Every Interpreters belongs to an InterpreterGroup.Interpreters in the same InterpreterGroup can reference each other. For example, SparkSqlInterpreter can reference SparkInterpreter to get SparkContext from it while they&#39;re in the same group.In terpreterSetting is configuration of a given InterpreterGroup and a unit of start/stop interpreter.All Interpreters in the same InterpreterSetting are launched in a single, separate JVM process. The Interpreter communicates with Zeppelin engine via Thrift.In &#39;Separate Interpreter(scoped / isolated) for each note&#39; mode which you can see at the Interpreter Setting menu when you create a new interpreter, new interpreter instance will be created per notebook. But it still runs on the same JVM while they&#39;re in the same InterpreterSettings.Make your own InterpreterCreating a new interpreter is quite simple. Just extend org.apache.zeppelin.interpreter abstract class and implement some methods.You can include org.apache.zeppelin:zeppelin-interpreter:[VERSION] artifact in your build system. And you should put your jars under your interpreter directory with a specific directory name. Zeppelin server reads interpreter directories recursively and initializes interpreters including your own interpreter.There are three locations where you can store your interpreter group, name and other information. Zeppelin server tries to find the location below. Next, Zeppelin tries to find interpreter-setting.json in your interpreter jar. {ZEPPELIN_INTERPRETER_DIR}/{YOUR_OWN_INTERPRETER_DIR}/interpreter-setting.jsonHere is an example of interpreter-setting.json on your own interpreter.[ { &quot;group&quot;: &quot;your-group&quot;, &quot;name&quot;: &quot;your-name&quot;, &quot;className&quot;: &quot;your.own.interpreter.class&quot;, &quot;properties&quot;: { &quot;properties1&quot;: { &quot;envName&quot;: null, &quot;propertyName&quot;: &quot;property.1.name&quot;, &quot;defaultValue&quot;: &quot;propertyDefaultValue&quot;, &quot;description&quot;: &quot;Property description&quot; }, &q uot;properties2&quot;: { &quot;envName&quot;: PROPERTIES_2, &quot;propertyName&quot;: null, &quot;defaultValue&quot;: &quot;property2DefaultValue&quot;, &quot;description&quot;: &quot;Property 2 description&quot; }, ... } }, { ... } ]Finally, Zeppelin uses static initialization with the following:static { Interpreter.register(&quot;MyInterpreterName&quot;, MyClassName.class.getName()); }Static initialization is deprecated and will be supported until 0.6.0.The name will appear later in the interpreter name option box during the interpreter configuration process.The name of the interpreter is what you later write to identify a paragraph which should be interpreted using this interpreter.%MyInterpreterNamesome interpreter specific code...Programming Languages for InterpreterIf the interpreter uses a specific programming language ( like Scala, Python, SQL ), it is generally recommen ded to add a syntax highlighting supported for that to the notebook paragraph editor. To check out the list of languages supported, see the mode-*.js files under zeppelin-web/bower_components/ace-builds/src-noconflict or from github.com/ajaxorg/ace-builds. If you want to add a new set of syntax highlighting, Add the mode-*.js file to zeppelin-web/bower.json ( when built, zeppelin-web/src/index.html will be changed automatically. ).Add to the list of editorMode in zeppelin-web/src/app/notebook/paragraph/paragraph.controller.js - it follows the pattern &#39;ace/mode/x&#39; where x is the name.Add to the code that checks for % prefix and calls session.setMode(editorMode.x) in setParagraphMode located in zeppelin-web/src/app/notebook/paragraph/paragraph.controller.js.Install your interpreter binaryOnce you have built your interpreter, you can place it under the interpreter directory with all its dependencies.[ZEPPELIN_HOME]/interpreter/[INTERPRETER_NAME]/Configure your interp reterTo configure your interpreter you need to follow these steps:Add your interpreter class name to the zeppelin.interpreters property in conf/zeppelin-site.xml.Property value is comma separated [INTERPRETER_CLASS_NAME].For example,&lt;property&gt;&lt;name&gt;zeppelin.interpreters&lt;/name&gt;&lt;value&gt;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,com.me.MyNewInterpreter&lt;/value&gt;&lt;/property&gt;Add your interpreter to the default configuration which is used when there is no zeppelin-site.xml.Start Zeppelin by running ./bin/zeppelin-daemon.sh start.In the interpreter page, click the +Create button and configure your interpreter properties.Now you are done and ready to use your int erpreter.Note : Interpreters released with zeppelin have a default configuration which is used when there is no conf/zeppelin-site.xml.Use your interpreter0.5.0Inside of a notebook, %[INTERPRETER_NAME] directive will call your interpreter.Note that the first interpreter configuration in zeppelin.interpreters will be the default one.For example,%myintpval a = &quot;My interpreter&quot;println(a)0.6.0 and laterInside of a notebook, %[INTERPRETER_GROUP].[INTERPRETER_NAME] directive will call your interpreter.You can omit either [INTERPRETER_GROUP] or [INTERPRETER_NAME]. If you omit [INTERPRETER_NAME], then first available interpreter will be selected in the [INTERPRETER_GROUP].Likewise, if you skip [INTERPRETER_GROUP], then [INTERPRETER_NAME] will be chosen from default interpreter group.For example, if you have two interpreter myintp1 and myintp2 in group mygrp, you can call myintp1 like%mygrp.myintp1codes for myintp1and you can call myintp2 like%mygrp.myintp2codes for myintp2 If you omit your interpreter name, it&#39;ll select first available interpreter in the group ( myintp1 ).%mygrpcodes for myintp1You can only omit your interpreter group when your interpreter group is selected as a default group.%myintp2codes for myintp2ExamplesCheckout some interpreters released with Zeppelin by default.sparkmarkdownshelljdbcContributing a new Interpreter to Zeppelin releasesWe welcome contribution to a new interpreter. Please follow these few steps:First, check out the general contribution guide here.Follow the steps in Make your own Interpreter section above.Add your interpreter as in the Configure your interpreter section above; also add it to the example template zeppelin-site.xml.template.Add tests! They are run by Travis for all changes and it is important that they are self-contained.Include your interpreter as a module in pom.xml.Add documentation on how to use your interpreter under docs/interpreter/. Follow the Markdown style as this example. Make sure you list config settings and provide working examples on using your interpreter in code boxes in Markdown. Link to images as appropriate (images should go to docs/assets/themes/zeppelin/img/docs-img/). And add a link to your documentation in the navigation menu (docs/_includes/themes/zeppelin/_navigation.html).Most importantly, ensure licenses of the transitive closure of all dependencies are list in license file.Commit your changes and open a Pull Request on the project Mirror on GitHub; check to make sure Travis CI build is passing.", + "content" : "<!--Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.-->Writing a New InterpreterWhat is Apache Zeppelin InterpreterApache Zeppelin Interpreter is a language backend. For example to use scala code in Zeppelin, you need a scala interpreter.Every Interpreters belongs to an InterpreterGroup.Interpreters in the same InterpreterGroup can reference each other. For example, SparkSqlInterpreter can reference SparkInterpreter to get SparkContext from it while they&#39;re in the same group.In terpreterSetting is configuration of a given InterpreterGroup and a unit of start/stop interpreter.All Interpreters in the same InterpreterSetting are launched in a single, separate JVM process. The Interpreter communicates with Zeppelin engine via Thrift.In &#39;Separate Interpreter(scoped / isolated) for each note&#39; mode which you can see at the Interpreter Setting menu when you create a new interpreter, new interpreter instance will be created per notebook. But it still runs on the same JVM while they&#39;re in the same InterpreterSettings.Make your own InterpreterCreating a new interpreter is quite simple. Just extend org.apache.zeppelin.interpreter abstract class and implement some methods.You can include org.apache.zeppelin:zeppelin-interpreter:[VERSION] artifact in your build system. And you should put your jars under your interpreter directory with a specific directory name. Zeppelin server reads interpreter directories recursively and initializes interpreters including your own interpreter.There are three locations where you can store your interpreter group, name and other information. Zeppelin server tries to find the location below. Next, Zeppelin tries to find interpreter-setting.json in your interpreter jar.{ZEPPELIN_INTERPRETER_DIR}/{YOUR_OWN_INTERPRETER_DIR}/interpreter-setting.jsonHere is an example of interpreter-setting.json on your own interpreter.[ { &quot;group&quot;: &quot;your-group&quot;, &quot;name&quot;: &quot;your-name&quot;, &quot;className&quot;: &quot;your.own.interpreter.class&quot;, &quot;properties&quot;: { &quot;properties1&quot;: { &quot;envName&quot;: null, &quot;propertyName&quot;: &quot;property.1.name&quot;, &quot;defaultValue&quot;: &quot;propertyDefaultValue&quot;, &quot;description&quot;: &quot;Property description&quot; }, &qu ot;properties2&quot;: { &quot;envName&quot;: PROPERTIES_2, &quot;propertyName&quot;: null, &quot;defaultValue&quot;: &quot;property2DefaultValue&quot;, &quot;description&quot;: &quot;Property 2 description&quot; }, ... } }, { ... }]Finally, Zeppelin uses static initialization with the following:static { Interpreter.register(&quot;MyInterpreterName&quot;, MyClassName.class.getName()); }Static initialization is deprecated and will be supported until 0.6.0.The name will appear later in the interpreter name option box during the interpreter configuration process.The name of the interpreter is what you later write to identify a paragraph which should be interpreted using this interpreter.%MyInterpreterNamesome interpreter specific code...Programming Languages for InterpreterIf the interpreter uses a specific programming language ( like Scala, Python, SQL ), it is generally recommende d to add a syntax highlighting supported for that to the notebook paragraph editor. To check out the list of languages supported, see the mode-*.js files under zeppelin-web/bower_components/ace-builds/src-noconflict or from github.com/ajaxorg/ace-builds. If you want to add a new set of syntax highlighting, Add the mode-*.js file to zeppelin-web/bower.json ( when built, zeppelin-web/src/index.html will be changed automatically. ).Add to the list of editorMode in zeppelin-web/src/app/notebook/paragraph/paragraph.controller.js - it follows the pattern &#39;ace/mode/x&#39; where x is the name.Add to the code that checks for % prefix and calls session.setMode(editorMode.x) in setParagraphMode located in zeppelin-web/src/app/notebook/paragraph/paragraph.controller.js.Install your interpreter binaryOnce you have built your interpreter, you can place it under the interpreter directory with all its dependencies.[ZEPPELIN_HOME]/interpreter/[INTERPRETER_NAME]/Configure your interpre terTo configure your interpreter you need to follow these steps:Add your interpreter class name to the zeppelin.interpreters property in conf/zeppelin-site.xml.Property value is comma separated [INTERPRETER_CLASS_NAME].For example,&lt;property&gt;&lt;name&gt;zeppelin.interpreters&lt;/name&gt;&lt;value&gt;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,com.me.MyNewInterpreter&lt;/value&gt;&lt;/property&gt;Add your interpreter to the default configuration which is used when there is no zeppelin-site.xml.Start Zeppelin by running ./bin/zeppelin-daemon.sh start.In the interpreter page, click the +Create button and configure your interpreter properties.Now you are done and ready to use your inter preter.Note : Interpreters released with zeppelin have a default configuration which is used when there is no conf/zeppelin-site.xml.Use your interpreter0.5.0Inside of a notebook, %[INTERPRETER_NAME] directive will call your interpreter.Note that the first interpreter configuration in zeppelin.interpreters will be the default one.For example,%myintpval a = &quot;My interpreter&quot;println(a)0.6.0 and laterInside of a notebook, %[INTERPRETER_GROUP].[INTERPRETER_NAME] directive will call your interpreter.You can omit either [INTERPRETER_GROUP] or [INTERPRETER_NAME]. If you omit [INTERPRETER_NAME], then first available interpreter will be selected in the [INTERPRETER_GROUP].Likewise, if you skip [INTERPRETER_GROUP], then [INTERPRETER_NAME] will be chosen from default interpreter group.For example, if you have two interpreter myintp1 and myintp2 in group mygrp, you can call myintp1 like%mygrp.myintp1codes for myintp1and you can call myintp2 like%mygrp.myintp2codes for myintp2If you omit your interpreter name, it&#39;ll select first available interpreter in the group ( myintp1 ).%mygrpcodes for myintp1You can only omit your interpreter group when your interpreter group is selected as a default group.%myintp2codes for myintp2ExamplesCheckout some interpreters released with Zeppelin by default.sparkmarkdownshelljdbcContributing a new Interpreter to Zeppelin releasesWe welcome contribution to a new interpreter. Please follow these few steps:First, check out the general contribution guide here.Follow the steps in Make your own Interpreter section above.Add your interpreter as in the Configure your interpreter section above; also add it to the example template zeppelin-site.xml.template.Add tests! They are run by Travis for all changes and it is important that they are self-contained.Include your interpreter as a module in pom.xml.Add documentation on how to use your interpreter under docs/interpreter/. Follow the Markdown style as this example. Make sure y ou list config settings and provide working examples on using your interpreter in code boxes in Markdown. Link to images as appropriate (images should go to docs/assets/themes/zeppelin/img/docs-img/). And add a link to your documentation in the navigation menu (docs/_includes/themes/zeppelin/_navigation.html).Most importantly, ensure licenses of the transitive closure of all dependencies are list in license file.Commit your changes and open a Pull Request on the project Mirror on GitHub; check to make sure Travis CI build is passing.", "url": " /development/writingzeppelininterpreter.html", "group": "development", "excerpt": "Apache Zeppelin Interpreter is a language backend. Every Interpreters belongs to an InterpreterGroup. Interpreters in the same InterpreterGroup can reference each other." @@ -93,7 +93,7 @@ "/install/install.html": { "title": "Quick Start", - "content" : "<!--Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.-->Quick StartWelcome to your first trial to explore Apache Zeppelin! This page will help you to get started and here is the list of topics covered.InstallationApache Zeppelin officially supports and is tested on next environments. Name Value Oracle JDK 1.7 (set JAVA_HOME) OS Mac OSX Ubuntu 14.X CentOS 6.X Windows 7 Pro SP1 There are two options to install Apache Zeppelin on your machine. One is downlo ading pre-built binary package from the archive. You can download not only the latest stable version but also the older one if you need. The other option is building from the source.Although it can be unstable somehow since it is on development status, you can explore newly added feature and change it as you want.Downloading Binary PackageIf you want to install Apache Zeppelin with a stable binary package, please visit Apache Zeppelin download Page. If you have downloaded netinst binary, install additional interpreters before you start Zeppelin. Or simply run ./bin/install-interpreter.sh --all.After unpacking, jump to Starting Apache Zeppelin with Command Line section.Building from SourceIf you want to build from the source, the software below needs to be installed on your system. Name Value Git Maven 3.1.x or higher If you don&#39;t have it installed yet, please check Before Build section and follow step by step instructions from there.1. Clone Apa che Zeppelin repositorygit clone https://github.com/apache/zeppelin.git2. Build source with optionsEach interpreters requires different build options. For the further information about options, please see Build section.mvn clean package -DskipTests [Options]Here are some examples with several options# build with spark-2.0, scala-2.11./dev/change_scala_version.sh 2.11mvn clean package -Pspark-2.0 -Phadoop-2.4 -Pyarn -Ppyspark -Psparkr -Pscala-2.11# build with spark-1.6, scala-2.10mvn clean package -Pspark-1.6 -Phadoop-2.4 -Pyarn -Ppyspark -Psparkr# spark-cassandra integrationmvn clean package -Pcassandra-spark-1.5 -Dhadoop.version=2.6.0 -Phadoop-2.6 -DskipTests# with CDHmvn clean package -Pspark-1.5 -Dhadoop.version=2.6.0-cdh5.5.0 -Phadoop-2.6 -Pvendor-repo -DskipTests# with MapRmvn clean package -Pspark-1.5 -Pmapr50 -DskipTestsFor the further information about building with source, please see README.md in Zeppelin repository.Starting Apache Zeppelin with Command LineStart Zeppelinbi n/zeppelin-daemon.sh startIf you are using Windows binzeppelin.cmdAfter successful start, visit http://localhost:8080 with your web browser.Stop Zeppelinbin/zeppelin-daemon.sh stop(Optional) Start Apache Zeppelin with a service managerNote : The below description was written based on Ubuntu Linux.Apache Zeppelin can be auto started as a service with an init script, such as services managed by upstart.The following is an example of upstart script to be saved as /etc/init/zeppelin.confThis also allows the service to be managed with commands such assudo service zeppelin start sudo service zeppelin stop sudo service zeppelin restartOther service managers could use a similar approach with the upstart argument passed to the zeppelin-daemon.sh script.bin/zeppelin-daemon.sh upstartzeppelin.confdescription &quot;zeppelin&quot;start on (local-filesystems and net-device-up IFACE!=lo)stop on shutdown# Respawn the process on unexpected terminationrespawn# respawn the job up to 7 times within a 5 second period.# If the job exceeds these values, it will be stopped and marked as failed.respawn limit 7 5# zeppelin was installed in /usr/share/zeppelin in this examplechdir /usr/share/zeppelinexec bin/zeppelin-daemon.sh upstartWhat is the next?Congratulation on your successful Apache Zeppelin installation! Here are two next steps you might need.If you are new to Apache ZeppelinFor an in-depth overview of Apache Zeppelin UI, head to Explore Apache Zeppelin UI.After getting familiar with Apache Zeppelin UI, have fun with a short walk-through Tutorial that uses Apache Spark backend.If you need more configuration setting for Apache Zeppelin, jump to the next section: Apache Zeppelin Configuration.If you need more information about Spark or JDBC interpreter settingApache Zeppelin provides deep integration with Apache Spark. For the further informtation, see Spark Interpreter for Apache Zeppelin. Also, you can use generic JDBC connections in Apache Zeppelin. Go to Generic JDB C Interpreter for Apache Zeppelin.If you are in multi-user environmentYou can set permissions for your notebooks and secure data resource in multi-user environment. Go to More -&gt; Security section.Apache Zeppelin ConfigurationYou can configure Apache Zeppelin with both environment variables in conf/zeppelin-env.sh (confzeppelin-env.cmd for Windows) and Java properties in conf/zeppelin-site.xml. If both are defined, then the environment variables will take priority. zepplin-env.sh zepplin-site.xml Default value Description ZEPPELIN_PORT zeppelin.server.port 8080 Zeppelin server port ZEPPELIN_MEM N/A -Xmx1024m -XX:MaxPermSize=512m JVM mem options ZEPPELIN_INTP_MEM N/A ZEPPELIN_MEM JVM mem options for interpreter process ZEPPELIN_JAVA_OPTS N/A JVM options ZEPPELIN_ALLOWED_ORIGINS zeppelin.server.allowed.origins * Enables a way to specify a ',' separated list of allowed origins f or rest and websockets. i.e. http://localhost:8080 N/A zeppelin.anonymous.allowed true Anonymous user is allowed by default. ZEPPELIN_SERVER_CONTEXT_PATH zeppelin.server.context.path / A context path of the web application ZEPPELIN_SSL zeppelin.ssl false ZEPPELIN_SSL_CLIENT_AUTH zeppelin.ssl.client.auth false ZEPPELIN_SSL_KEYSTORE_PATH zeppelin.ssl.keystore.path keystore ZEPPELIN_SSL_KEYSTORE_TYPE zeppelin.ssl.keystore.type JKS ZEPPELIN_SSL_KEYSTORE_PASSWORD zeppelin.ssl.keystore.password ZEPPELIN_SSL_KEY_MANAGER_PASSWORD zeppelin.ssl.key.manager.password ZEPPELIN_SSL_TRUSTSTORE_PATH zeppelin.ssl.truststore.path ZEPPELIN_SSL_TRUSTSTORE_TYPE zeppelin.ssl.truststore.type ZEPPELIN_SSL_TRUSTSTORE_PASSWORD zeppelin.ssl.truststore.password ZEPPELIN_NOTEBOOK_HOMESCREEN zeppelin.notebook.ho mescreen A notebook id displayed in Apache Zeppelin homescreen i.e. 2A94M5J1Z ZEPPELIN_NOTEBOOK_HOMESCREEN_HIDE zeppelin.notebook.homescreen.hide false This value can be "true" when to hide the notebook id set by ZEPPELIN_NOTEBOOK_HOMESCREEN on the Apache Zeppelin homescreen. For the further information, please read Customize your Zeppelin homepage. ZEPPELIN_WAR_TEMPDIR zeppelin.war.tempdir webapps A location of jetty temporary directory ZEPPELIN_NOTEBOOK_DIR zeppelin.notebook.dir notebook The root directory where notebook directories are saved ZEPPELIN_NOTEBOOK_S3_BUCKET zeppelin.notebook.s3.bucket zeppelin S3 Bucket where notebook files will be saved ZEPPELIN_NOTEBOOK_S3_USER zeppelin.notebook.s3.user user A user name of S3 bucketi.e. bucket/user/notebook/2A94M5J1Z/note.json ZEPPELIN_NOTEBOOK_S3_ENDPOINT zeppelin.notebook.s3.endpoint s3.amazonaws.com Endpoint for the bu cket ZEPPELIN_NOTEBOOK_S3_KMS_KEY_ID zeppelin.notebook.s3.kmsKeyID AWS KMS Key ID to use for encrypting data in S3 (optional) ZEPPELIN_NOTEBOOK_S3_EMP zeppelin.notebook.s3.encryptionMaterialsProvider Class name of a custom S3 encryption materials provider implementation to use for encrypting data in S3 (optional) ZEPPELIN_NOTEBOOK_AZURE_CONNECTION_STRING zeppelin.notebook.azure.connectionString The Azure storage account connection stringi.e. DefaultEndpointsProtocol=https;AccountName=&lt;accountName&gt;;AccountKey=&lt;accountKey&gt; ZEPPELIN_NOTEBOOK_AZURE_SHARE zeppelin.notebook.azure.share zeppelin Share where the notebook files will be saved ZEPPELIN_NOTEBOOK_AZURE_USER zeppelin.notebook.azure.user user An optional user name of Azure file sharei.e. share/user/notebook/2A94M5J1Z/note.json ZEPPELIN_NOTEBOOK_STORAGE zeppelin.notebook.storage org.apache.zeppelin.notebook.re po.VFSNotebookRepo Comma separated list of notebook storage ZEPPELIN_NOTEBOOK_ONE_WAY_SYNC zeppelin.notebook.one.way.sync false If there are multiple notebook storages, should we treat the first one as the only source of truth? 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, ... Comma separated interpreter configurations [Class] NOTE: This property is deprecated since Zeppelin-0.6.0 and will not be supported from Zeppelin-0.7.0 ZEPPELIN_INTERPRETER_DIR zeppelin.interpreter.dir interpreter Interpreter directory ZEPPELIN_WEBSOCKET_MAX_TEXT_MESSAGE_SIZE zeppelin.websocket.max.text.message.size 1024000 Size in characters of the maximum text message to be received by websocket. ", + "content" : "<!--Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.-->Quick StartWelcome to your first trial to explore Apache Zeppelin! This page will help you to get started and here is the list of topics covered.InstallationApache Zeppelin officially supports and is tested on next environments. Name Value Oracle JDK 1.7 (set JAVA_HOME) OS Mac OSX Ubuntu 14.X CentOS 6.X Windows 7 Pro SP1 There are two options to install Apache Zeppelin on your machine. One is downlo ading pre-built binary package from the archive. You can download not only the latest stable version but also the older one if you need. The other option is building from the source.Although it can be unstable somehow since it is on development status, you can explore newly added feature and change it as you want.Downloading Binary PackageIf you want to install Apache Zeppelin with a stable binary package, please visit Apache Zeppelin download Page. If you have downloaded netinst binary, install additional interpreters before you start Zeppelin. Or simply run ./bin/install-interpreter.sh --all.After unpacking, jump to Starting Apache Zeppelin with Command Line section.Building from SourceIf you want to build from the source, the software below needs to be installed on your system. Name Value Git Maven 3.1.x or higher If you don&#39;t have it installed yet, please check Before Build section and follow step by step instructions from there.1. Clone Apa che Zeppelin repositorygit clone https://github.com/apache/zeppelin.git2. Build source with optionsEach interpreters requires different build options. For the further information about options, please see Build section.mvn clean package -DskipTests [Options]Here are some examples with several options# build with spark-2.0, scala-2.11./dev/change_scala_version.sh 2.11mvn clean package -Pspark-2.0 -Phadoop-2.4 -Pyarn -Ppyspark -Psparkr -Pscala-2.11# build with spark-1.6, scala-2.10mvn clean package -Pspark-1.6 -Phadoop-2.4 -Pyarn -Ppyspark -Psparkr# spark-cassandra integrationmvn clean package -Pcassandra-spark-1.5 -Dhadoop.version=2.6.0 -Phadoop-2.6 -DskipTests# with CDHmvn clean package -Pspark-1.5 -Dhadoop.version=2.6.0-cdh5.5.0 -Phadoop-2.6 -Pvendor-repo -DskipTests# with MapRmvn clean package -Pspark-1.5 -Pmapr50 -DskipTestsFor the further information about building with source, please see README.md in Zeppelin repository.Starting Apache Zeppelin with Command LineStart Zeppelinbi n/zeppelin-daemon.sh startIf you are using Windows binzeppelin.cmdAfter successful start, visit http://localhost:8080 with your web browser.Stop Zeppelinbin/zeppelin-daemon.sh stop(Optional) Start Apache Zeppelin with a service managerNote : The below description was written based on Ubuntu Linux.Apache Zeppelin can be auto started as a service with an init script, such as services managed by upstart.The following is an example of upstart script to be saved as /etc/init/zeppelin.confThis also allows the service to be managed with commands such assudo service zeppelin start sudo service zeppelin stop sudo service zeppelin restartOther service managers could use a similar approach with the upstart argument passed to the zeppelin-daemon.sh script.bin/zeppelin-daemon.sh upstartzeppelin.confdescription &quot;zeppelin&quot;start on (local-filesystems and net-device-up IFACE!=lo)stop on shutdown# Respawn the process on unexpected terminationrespawn# respawn the job up to 7 times within a 5 second period.# If the job exceeds these values, it will be stopped and marked as failed.respawn limit 7 5# zeppelin was installed in /usr/share/zeppelin in this examplechdir /usr/share/zeppelinexec bin/zeppelin-daemon.sh upstartWhat is the next?Congratulation on your successful Apache Zeppelin installation! Here are two next steps you might need.If you are new to Apache ZeppelinFor an in-depth overview of Apache Zeppelin UI, head to Explore Apache Zeppelin UI.After getting familiar with Apache Zeppelin UI, have fun with a short walk-through Tutorial that uses Apache Spark backend.If you need more configuration setting for Apache Zeppelin, jump to the next section: Apache Zeppelin Configuration.If you need more information about Spark or JDBC interpreter settingApache Zeppelin provides deep integration with Apache Spark. For the further informtation, see Spark Interpreter for Apache Zeppelin. Also, you can use generic JDBC connections in Apache Zeppelin. Go to Generic JDB C Interpreter for Apache Zeppelin.If you are in multi-user environmentYou can set permissions for your notebooks and secure data resource in multi-user environment. Go to More -&gt; Security section.Apache Zeppelin ConfigurationYou can configure Apache Zeppelin with both environment variables in conf/zeppelin-env.sh (confzeppelin-env.cmd for Windows) and Java properties in conf/zeppelin-site.xml. If both are defined, then the environment variables will take priority. zeppelin-env.sh zeppelin-site.xml Default value Description ZEPPELIN_PORT zeppelin.server.port 8080 Zeppelin server port ZEPPELIN_MEM N/A -Xmx1024m -XX:MaxPermSize=512m JVM mem options ZEPPELIN_INTP_MEM N/A ZEPPELIN_MEM JVM mem options for interpreter process ZEPPELIN_JAVA_OPTS N/A JVM options ZEPPELIN_ALLOWED_ORIGINS zeppelin.server.allowed.origins * Enables a way to specify a ',' separated list of allowed origins for rest and websockets. i.e. http://localhost:8080 N/A zeppelin.anonymous.allowed true Anonymous user is allowed by default. ZEPPELIN_SERVER_CONTEXT_PATH zeppelin.server.context.path / A context path of the web application ZEPPELIN_SSL zeppelin.ssl false ZEPPELIN_SSL_CLIENT_AUTH zeppelin.ssl.client.auth false ZEPPELIN_SSL_KEYSTORE_PATH zeppelin.ssl.keystore.path keystore ZEPPELIN_SSL_KEYSTORE_TYPE zeppelin.ssl.keystore.type JKS ZEPPELIN_SSL_KEYSTORE_PASSWORD zeppelin.ssl.keystore.password ZEPPELIN_SSL_KEY_MANAGER_PASSWORD zeppelin.ssl.key.manager.password ZEPPELIN_SSL_TRUSTSTORE_PATH zeppelin.ssl.truststore.path ZEPPELIN_SSL_TRUSTSTORE_TYPE zeppelin.ssl.truststore.type ZEPPELIN_SSL_TRUSTSTORE_PASSWORD zeppelin.ssl.truststore.password ZEPPELIN_NOTEBOOK_HOMESCREEN zeppelin.notebook. homescreen A notebook id displayed in Apache Zeppelin homescreen i.e. 2A94M5J1Z ZEPPELIN_NOTEBOOK_HOMESCREEN_HIDE zeppelin.notebook.homescreen.hide false This value can be "true" when to hide the notebook id set by ZEPPELIN_NOTEBOOK_HOMESCREEN on the Apache Zeppelin homescreen. For the further information, please read Customize your Zeppelin homepage. ZEPPELIN_WAR_TEMPDIR zeppelin.war.tempdir webapps A location of jetty temporary directory ZEPPELIN_NOTEBOOK_DIR zeppelin.notebook.dir notebook The root directory where notebook directories are saved ZEPPELIN_NOTEBOOK_S3_BUCKET zeppelin.notebook.s3.bucket zeppelin S3 Bucket where notebook files will be saved ZEPPELIN_NOTEBOOK_S3_USER zeppelin.notebook.s3.user user A user name of S3 bucketi.e. bucket/user/notebook/2A94M5J1Z/note.json ZEPPELIN_NOTEBOOK_S3_ENDPOINT zeppelin.notebook.s3.endpoint s3.amazonaws.com Endpoint for the bucket ZEPPELIN_NOTEBOOK_S3_KMS_KEY_ID zeppelin.notebook.s3.kmsKeyID AWS KMS Key ID to use for encrypting data in S3 (optional) ZEPPELIN_NOTEBOOK_S3_EMP zeppelin.notebook.s3.encryptionMaterialsProvider Class name of a custom S3 encryption materials provider implementation to use for encrypting data in S3 (optional) ZEPPELIN_NOTEBOOK_AZURE_CONNECTION_STRING zeppelin.notebook.azure.connectionString The Azure storage account connection stringi.e. DefaultEndpointsProtocol=https;AccountName=&lt;accountName&gt;;AccountKey=&lt;accountKey&gt; ZEPPELIN_NOTEBOOK_AZURE_SHARE zeppelin.notebook.azure.share zeppelin Share where the notebook files will be saved ZEPPELIN_NOTEBOOK_AZURE_USER zeppelin.notebook.azure.user user An optional user name of Azure file sharei.e. share/user/notebook/2A94M5J1Z/note.json ZEPPELIN_NOTEBOOK_STORAGE zeppelin.notebook.storage org.apache.zeppelin.notebook. repo.VFSNotebookRepo Comma separated list of notebook storage ZEPPELIN_NOTEBOOK_ONE_WAY_SYNC zeppelin.notebook.one.way.sync false If there are multiple notebook storages, should we treat the first one as the only source of truth? 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, ... Comma separated interpreter configurations [Class] NOTE: This property is deprecated since Zeppelin-0.6.0 and will not be supported from Zeppelin-0.7.0 ZEPPELIN_INTERPRETER_DIR zeppelin.interpreter.dir interpreter Interpreter directory ZEPPELIN_WEBSOCKET_MAX_TEXT_MESSAGE_SIZE zeppelin.websocket.max.text.message.size 1024000 Size in characters of the maximum text messa ge to be received by websocket. ", "url": " /install/install.html", "group": "install", "excerpt": "This page will help you to get started and guide you through installation of Apache Zeppelin, running it in the command line and basic configuration options." @@ -104,10 +104,10 @@ "/install/spark_cluster_mode.html": { "title": "Apache Zeppelin on Spark cluster mode", - "content" : "<!--Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.-->Apache Zeppelin on Spark Cluster ModeOverviewApache Spark has supported three cluster manager types(Standalone, Apache Mesos and Hadoop YARN) so far.This document will guide you how you can build and configure the environment on 3 types of Spark cluster manager with Apache Zeppelin using Docker scripts.So install docker on the machine first.Spark standalone modeSpark standalone is a simple cluster manager included with Spark that m akes it easy to set up a cluster.You can simply set up Spark standalone environment with below steps. Note : Since Apache Zeppelin and Spark use same 8080 port for their web UI, you might need to change zeppelin.server.port in conf/zeppelin-site.xml.1. Build Docker fileYou can find docker script files under scripts/docker/spark-cluster-managers.cd $ZEPPELIN_HOME/scripts/docker/spark-cluster-managers/spark_standalonedocker build -t &quot;spark_standalone&quot; .2. Run dockerdocker run -it -p 8080:8080 -p 7077:7077 -p 8888:8888 -p 8081:8081 -h sparkmaster --name spark_standalone spark_standalone bash; 3. Configure Spark interpreter in ZeppelinSet Spark master as spark://localhost:7077 in Zeppelin Interpreters setting page.4. Run Zeppelin with Spark interpreterAfter running single paragraph with Spark interpreter in Zeppelin, browse https://localhost:8080 and check whether Spark cluster is running well or not.You can also simply verify that Spark is running well in Docker with below command.ps -ef | grep spark", + "content" : "<!--Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.-->Apache Zeppelin on Spark Cluster ModeOverviewApache Spark has supported three cluster manager types(Standalone, Apache Mesos and Hadoop YARN) so far.This document will guide you how you can build and configure the environment on 3 types of Spark cluster manager with Apache Zeppelin using Docker scripts.So install docker on the machine first.Spark standalone modeSpark standalone is a simple cluster manager included with Spark that m akes it easy to set up a cluster.You can simply set up Spark standalone environment with below steps. Note : Since Apache Zeppelin and Spark use same 8080 port for their web UI, you might need to change zeppelin.server.port in conf/zeppelin-site.xml.1. Build Docker fileYou can find docker script files under scripts/docker/spark-cluster-managers.cd $ZEPPELIN_HOME/scripts/docker/spark-cluster-managers/spark_standalonedocker build -t &quot;spark_standalone&quot; .2. Run dockerdocker run -it -p 8080:8080 -p 7077:7077 -p 8888:8888 -p 8081:8081 -h sparkmaster --name spark_standalone spark_standalone bash; 3. Configure Spark interpreter in ZeppelinSet Spark master as spark://&lt;hostname&gt;:7077 in Zeppelin Interpreters setting page.4. Run Zeppelin with Spark interpreterAfter running single paragraph with Spark interpreter in Zeppelin, browse https://&lt;hostname&gt;:8080 and check whether Spark cluster is running well or not.You can also simply verify that Spark i s running well in Docker with below command.ps -ef | grep sparkSpark on YARN modeYou can simply set up Spark on YARN docker environment with below steps.Note : Since Apache Zeppelin and Spark use same 8080 port for their web UI, you might need to change zeppelin.server.port in conf/zeppelin-site.xml.1. Build Docker fileYou can find docker script files under scripts/docker/spark-cluster-managers.cd $ZEPPELIN_HOME/scripts/docker/spark-cluster-managers/spark_yarndocker build -t &quot;spark_yarn&quot; .2. Run dockerdocker run -it -p 5000:5000 -p 9000:9000 -p 9001:9001 -p 8088:8088 -p 8042:8042 -p 8030:8030 -p 8031:8031 -p 8032:8032 -p 8033:8033 -p 8080:8080 -p 7077:7077 -p 8888:8888 -p 8081:8081 -p 50010:50010 -p 50075:50075 -p 50020:50020 -p 50070:50070 --name spark_yarn -h sparkmaster spark_yarn bash;3. Verify running Spark on YARN.You can simply verify the processes of Spark and YARN are running well in Docker with below command.ps -efYou can also check ea ch application web UI for HDFS on http://&lt;hostname&gt;:50070/, YARN on http://&lt;hostname&gt;:8088/cluster and Spark on http://&lt;hostname&gt;:8080/.4. Configure Spark interpreter in ZeppelinSet following configurations to conf/zeppelin-env.sh.export MASTER=yarn-clientexport HADOOP_CONF_DIR=[your_hadoop_conf_path]export SPARK_HOME=[your_spark_home_path]HADOOP_CONF_DIR(Hadoop configuration path) is defined in /scripts/docker/spark-cluster-managers/spark_yarn_cluster/hdfs_conf.Don&#39;t forget to set Spark master as yarn-client in Zeppelin Interpreters setting page like below.5. Run Zeppelin with Spark interpreterAfter running a single paragraph with Spark interpreter in Zeppelin, browse http://&lt;hostname&gt;:8088/cluster/apps and check Zeppelin application is running well or not.Spark on Mesos modeYou can simply set up Spark on Mesos docker environment with below steps.1. Build Docker filecd $ZEPPELIN_HOME/scripts/docker/spark-cluster-manage rs/spark_mesosdocker build -t &quot;spark_mesos&quot; .2. Run dockerdocker run --net=host -it -p 8080:8080 -p 7077:7077 -p 8888:8888 -p 8081:8081 -p 8082:8082 -p 5050:5050 -p 5051:5051 -p 4040:4040 -h sparkmaster --name spark_mesos spark_mesos bash;3. Verify running Spark on Mesos.You can simply verify the processes of Spark and Mesos are running well in Docker with below command.ps -efYou can also check each application web UI for Mesos on http://&lt;hostname&gt;:5050/cluster and Spark on http://&lt;hostname&gt;:8080/.4. Configure Spark interpreter in Zeppelinexport MASTER=mesos://127.0.1.1:5050export MESOS_NATIVE_JAVA_LIBRARY=[PATH OF libmesos.so]export SPARK_HOME=[PATH OF SPARK HOME]Don&#39;t forget to set Spark master as mesos://127.0.1.1:5050 in Zeppelin Interpreters setting page like below.5. Run Zeppelin with Spark interpreterAfter running a single paragraph with Spark interpreter in Zeppelin, browse http://&lt;hostname&gt;:5050/#/framework s and check Zeppelin application is running well or not.", "url": " /install/spark_cluster_mode.html", "group": "install", - "excerpt": "" + "excerpt": "This document will guide you how you can build and configure the environment on 3 types of Spark cluster manager(Standalone, Hadoop Yarn, Apache Mesos) with Apache Zeppelin using docker scripts." } , @@ -115,7 +115,7 @@ "/install/upgrade.html": { "title": "Manual Zeppelin version upgrade procedure", - "content" : "<!--Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.-->Manual upgrade procedure for ZeppelinBasically, newer version of Zeppelin works with previous version notebook directory and configurations.So, copying notebook and conf directory should be enough.InstructionsStop Zeppelinbin/zeppelin-daemon.sh stopCopy your notebook and conf directory into a backup directoryDownload newer version of Zeppelin and Install. See Install page.Copy backup notebook and conf directory into newer version o f Zeppelin notebook and conf directoryStart Zeppelinbin/zeppelin-daemon.sh start", + "content" : "<!--Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.-->Manual upgrade procedure for ZeppelinBasically, newer version of Zeppelin works with previous version notebook directory and configurations.So, copying notebook and conf directory should be enough.InstructionsStop Zeppelinbin/zeppelin-daemon.sh stopCopy your notebook and conf directory into a backup directoryDownload newer version of Zeppelin and Install. See Install page.Copy backup notebook and conf directory into newer version o f Zeppelin notebook and conf directoryStart Zeppelinbin/zeppelin-daemon.sh startMigration GuideUpgrading from Zeppelin 0.6 to 0.7From 0.7, we don&#39;t use ZEPPELIN_JAVA_OPTS as default value of ZEPPELIN_INTP_JAVA_OPTS and also the same for ZEPPELIN_MEM/ZEPPELIN_INTP_MEM. If user want to configure the jvm opts of interpreter process, please set ZEPPELIN_INTP_JAVA_OPTS and ZEPPELIN_INTP_MEM explicitly.Mapping from %jdbc(prefix) to %prefix is no longer available. Instead, you can use %[interpreter alias] with multiple interpreter setttings on GUI.", "url": " /install/upgrade.html", "group": "install", "excerpt": "This document will guide you through a procedure of manual upgrade your Apache Zeppelin instance to a newer version. Apache Zeppelin keeps backward compatibility for the notebook file format." @@ -501,7 +501,7 @@ "/rest-api/rest-notebook.html": { "title": "Apache Zeppelin Notebook REST API", - "content" : "<!--Licensed under the Apache License, Version 2.0 (the "License");you may not use this file except in compliance with the License.You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, softwaredistributed under the License is distributed on an "AS IS" BASIS,WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.See the License for the specific language governing permissions andlimitations under the License.-->Apache Zeppelin Notebook REST APIOverviewApache Zeppelin provides several REST APIs for interaction and remote activation of zeppelin functionality.All REST APIs are available starting with the following endpoint http://[zeppelin-server]:[zeppelin-port]/api. Note that Apache Zeppelin REST APIs receive or return JSON objects, it is recommended for you to install some JSON viewers such as JSONView.If you work with Apache Zeppelin and find a need for an additional REST API, please file an issue or send us an email.Notebook REST API ListNotebooks REST API supports the following operations: List, Create, Get, Delete, Clone, Run, Export, Import as detailed in the following tables.List of the notebooks Description This GET method lists the available notebooks on your server. Notebook JSON contains the name and id of all notebooks. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook Success code 200 Fail code 500 sample JSON response { &quot;status&quot;: &quot;OK&quot;, &quot;message&quot;: &quot;&quot;, &quot;body&quot;: [ { &quot;name&quot;:&quot;Homepage&quot;, &quot;id&quot;:&quot;2AV4WUEMK&quot; }, { &quot;name&quot;:&quot;Zeppelin Tutorial&quot;, &quot;id&quot;:&quot ;2A94M5J1Z&quot; } ]} Create a new notebook Description This POST method creates a new notebook using the given name or default name if none given. The body field of the returned JSON contains the new notebook id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook Success code 201 Fail code 500 sample JSON input (without paragraphs) {&quot;name&quot;: &quot;name of new notebook&quot;} sample JSON input (with initial paragraphs) { &quot;name&quot;: &quot;name of new notebook&quot;, &quot;paragraphs&quot;: [ { &quot;title&quot;: &quot;paragraph title1&quot;, &quot;text&quot;: &quot;paragraph text1&quot; }, { &quot;title&quot;: &quot;paragraph title2&quot;, &quot;text&quot;: &quot;paragraph text2&quot; } ]} sample JSON response { &quot;status&quot;: &quot;CREATED&quot;, &quot;message&quot;: &quot;&quot;, &quot;body&quot;: &quot;2AZPHY918&quot;} Get an existing notebook information Description This GET method retrieves an existing notebook&#39;s information using the given id. The body field of the returned JSON contain information about paragraphs in the notebook. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/[notebookId] Success code 200 Fail code 500 sample JSON response { &quot;status&quot;: &quot;OK&quot;, &quot;message&quot;: &quot;&quot;, &quot;body&quot;: { &quot;paragraphs&quot;: [ { &quot;text&quot;: &quot;%sql nselect age, count(1) valuenfrom bank nwhere age &lt; 30 ngroup by age norder by a ge&quot;, &quot;config&quot;: { &quot;colWidth&quot;: 4, &quot;graph&quot;: { &quot;mode&quot;: &quot;multiBarChart&quot;, &quot;height&quot;: 300, &quot;optionOpen&quot;: false, &quot;keys&quot;: [ { &quot;name&quot;: &quot;age&quot;, &quot;index&quot;: 0, &quot;aggr&quot;: &quot;sum&quot; } ], &quot;values&quot;: [ { &quot;name&quot;: &quot;value&quot;, &quot;index&quot;: 1, &quot;aggr&quot;: &quot;sum&quot; } ], &quot;groups&quot;: [], &quot;scatter&quot;: { &quot;xAxis&quot;: { &quot;name&quot;: &quot; age&quot;, &quot;index&quot;: 0, &quot;aggr&quot;: &quot;sum&quot; }, &quot;yAxis&quot;: { &quot;name&quot;: &quot;value&quot;, &quot;index&quot;: 1, &quot;aggr&quot;: &quot;sum&quot; } } } }, &quot;settings&quot;: { &quot;params&quot;: {}, &quot;forms&quot;: {} }, &quot;jobName&quot;: &quot;paragraph_1423500782552_-1439281894&quot;, &quot;id&quot;: &quot;20150210-015302_1492795503&quot;, &quot;result&quot;: { &quot;code&quot;: &quot;SUCCESS&quot;, &quot;type&quot;: &quot;TABLE&quot;, &quot;msg&quot;: &quot;agetvaluen19t4n20t3n21t7n22t9n23t20n24t24n25t44n26t77n27t94n28t103n29t97n&q uot; }, &quot;dateCreated&quot;: &quot;Feb 10, 2015 1:53:02 AM&quot;, &quot;dateStarted&quot;: &quot;Jul 3, 2015 1:43:17 PM&quot;, &quot;dateFinished&quot;: &quot;Jul 3, 2015 1:43:23 PM&quot;, &quot;status&quot;: &quot;FINISHED&quot;, &quot;progressUpdateIntervalMs&quot;: 500 } ], &quot;name&quot;: &quot;Zeppelin Tutorial&quot;, &quot;id&quot;: &quot;2A94M5J1Z&quot;, &quot;angularObjects&quot;: {}, &quot;config&quot;: { &quot;looknfeel&quot;: &quot;default&quot; }, &quot;info&quot;: {} }} Delete a notebook Description This DELETE method deletes a notebook by the given notebook id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/[notebookId] Success code 200 Fail code 500 sample JSON response {&quot;status&quot;: &quot;OK&quot;,&quot;message&quot;: &quot;&quot;} Clone a notebook Description This POST method clones a notebook by the given id and create a new notebook using the given name or default name if none given. The body field of the returned JSON contains the new notebook id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/[notebookId] Success code 201 Fail code 500 sample JSON input {&quot;name&quot;: &quot;name of new notebook&quot;} sample JSON response { &quot;status&quot;: &quot;CREATED&quot;, &quot;message&quot;: &quot;&quot;, &quot;body&quot;: &quot;2AZPHY918&quot;} Run all paragraphs Description This POST method runs all paragraphs in the given note book id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/job/[notebookId] Success code 200 Fail code 500 sample JSON response {&quot;status&quot;: &quot;OK&quot;} Stop all paragraphs Description This DELETE method stops all paragraphs in the given notebook id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/job/[notebookId] Success code 200 Fail code 500 sample JSON response {&quot;status&quot;:&quot;OK&quot;} Get the status of all paragraphs Description This GET method gets the status of all paragraphs by the given notebook id. The body field of the returned JSON contains of the array that compose of the paragraph id, paragraph status, paragraph finish date, paragraph started date. URL http ://[zeppelin-server]:[zeppelin-port]/api/notebook/job/[notebookId] Success code 200 Fail code 500 sample JSON response { &quot;status&quot;: &quot;OK&quot;, &quot;body&quot;: [ { &quot;id&quot;:&quot;20151121-212654_766735423&quot;, &quot;status&quot;:&quot;FINISHED&quot;, &quot;finished&quot;:&quot;Tue Nov 24 14:21:40 KST 2015&quot;, &quot;started&quot;:&quot;Tue Nov 24 14:21:39 KST 2015&quot; }, { &quot;progress&quot;:&quot;1&quot;, &quot;id&quot;:&quot;20151121-212657_730976687&quot;, &quot;status&quot;:&quot;RUNNING&quot;, &quot;finished&quot;:&quot;Tue Nov 24 14:21:35 KST 2015&quot;, &quot;started&quot;:&quot;Tue Nov 24 14:21:40 KST 2015&quot; } ]} Get the status of a single paragraph Description This GET method gets the status of a single paragraph by the given notebook and paragraph id. The body field of the returned JSON contains of the array that compose of the paragraph id, paragraph status, paragraph finish date, paragraph started date. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/job/[notebookId]/[paragraphId] Success code 200 Fail code 500 sample JSON response { &quot;status&quot;: &quot;OK&quot;, &quot;body&quot;: { &quot;id&quot;:&quot;20151121-212654_766735423&quot;, &quot;status&quot;:&quot;FINISHED&quot;, &quot;finished&quot;:&quot;Tue Nov 24 14:21:40 KST 2015&quot;, &quot;started&quot;:&quot;Tue Nov 24 14:21:39 KST 2015&quot; }} Run a paragraph Description This POST method runs the paragraph by given notebook and paragraph id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/job/[notebookId]/[paragraphId] Success code 200 Fail code 500 sample JSON input (optional, only needed when if you want to update dynamic form&#39;s value) { &quot;name&quot;: &quot;name of new notebook&quot;, &quot;params&quot;: { &quot;formLabel1&quot;: &quot;value1&quot;, &quot;formLabel2&quot;: &quot;value2&quot; }} sample JSON response {&quot;status&quot;: &quot;OK&quot;} Stop a paragraph Description This DELETE method stops the paragraph by given notebook and paragraph id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/job/[notebookId]/[paragraphId] Success code 200 Fail code 500 sample JSON response {&quot;status&quot;: &quot;OK&quot;} Add Cron Job Description This POST method adds cron job by the given notebook id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/cron/[notebookId] Success code 200 Fail code 500 sample JSON input {&quot;cron&quot;: &quot;cron expression of notebook&quot;} sample JSON response {&quot;status&quot;: &quot;OK&quot;} Remove Cron Job Description This DELETE method removes cron job by the given notebook id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/cron/[notebookId] Success code 200 Fail code 500 sample JSON response {&quot;status&quot;: &quot;OK&quot;} Get Cron Job Description This GET method gets cron job expression of given notebook id. The body field of the returned JSON contains the cron expression. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/cron/[notebookId] Success code 200 Fail code 500 sample JSON response {&quot;status&quot;: &quot;OK&quot;, &quot;body&quot;: &quot;* * * * * ?&quot;} Full text search through the paragraphs in all notebooks Description GET request will return list of matching paragraphs URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/search?q=[query] Success code 200 Fail code 500 Sample JSON response { &quot;status&quot;: &quot;OK&quot;, &quot;body&quot;: [ { &quot;id&quot;: &quot;/paragraph/&quot;, &quot;name&quot;:&quot;Notebook Name&quot ;, &quot;snippet&quot;:&quot;&quot;, &quot;text&quot;:&quot;&quot; } ]} Create a new paragraph Description This POST method create a new paragraph using JSON payload. The body field of the returned JSON contain the new paragraph id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/[notebookId]/paragraph Success code 201 Fail code 500 sample JSON input (add to the last) { &quot;title&quot;: &quot;Paragraph insert revised&quot;, &quot;text&quot;: &quot;%sparknprintln(&quot;Paragraph insert revised&quot;)&quot;} sample JSON input (add to specific index) { &quot;title&quot;: &quot;Paragraph insert revised&quot;, &quot;text&quot;: &quot;%sparknprintln(&quot;Paragraph insert revised&quot;)&quot;, &quot;index&q uot;: 0} sample JSON response { &quot;status&quot;: &quot;CREATED&quot;, &quot;message&quot;: &quot;&quot;, &quot;body&quot;: &quot;20151218-100330_1754029574&quot;} Get a paragraph information Description This GET method retrieves an existing paragraph&#39;s information using the given id. The body field of the returned JSON contain information about paragraph. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/[notebookId]/paragraph/[paragraphId] Success code 200 Fail code 500 sample JSON response { &quot;status&quot;: &quot;OK&quot;, &quot;message&quot;: &quot;&quot;, &quot;body&quot;: { &quot;title&quot;: &quot;Paragraph2&quot;, &quot;text&quot;: &quot;%sparknnprintln(&quot;it&#39;s paragraph2&quot ;)&quot;, &quot;dateUpdated&quot;: &quot;Dec 18, 2015 7:33:54 AM&quot;, &quot;config&quot;: { &quot;colWidth&quot;: 12, &quot;graph&quot;: { &quot;mode&quot;: &quot;table&quot;, &quot;height&quot;: 300, &quot;optionOpen&quot;: false, &quot;keys&quot;: [], &quot;values&quot;: [], &quot;groups&quot;: [], &quot;scatter&quot;: {} }, &quot;enabled&quot;: true, &quot;title&quot;: true, &quot;editorMode&quot;: &quot;ace/mode/scala&quot; }, &quot;settings&quot;: { &quot;params&quot;: {}, &quot;forms&quot;: {} }, &quot;jobName&quot;: &quot;paragraph_1450391574392_-1890856722&quot;, &quot;id&quot;: &quot;20151218-073254_1105602047&quot;, &quot;result&quot;: { &quot;code&am p;quot;: &quot;SUCCESS&quot;, &quot;type&quot;: &quot;TEXT&quot;, &quot;msg&quot;: &quot;it&#39;s paragraph2n&quot; }, &quot;dateCreated&quot;: &quot;Dec 18, 2015 7:32:54 AM&quot;, &quot;dateStarted&quot;: &quot;Dec 18, 2015 7:33:55 AM&quot;, &quot;dateFinished&quot;: &quot;Dec 18, 2015 7:33:55 AM&quot;, &quot;status&quot;: &quot;FINISHED&quot;, &quot;progressUpdateIntervalMs&quot;: 500 }} Move a paragraph to the specific index Description This POST method moves a paragraph to the specific index (order) from the notebook. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/[notebookId]/paragraph/[paragraphId]/move/[newIndex] Success code 200 Fail code 500 sample JSON response {&quot;status&quot;: &quot;OK&quot;,&am p;quot;message&quot;: &quot;&quot;} Delete a paragraph Description This DELETE method deletes a paragraph by the given notebook and paragraph id. URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/[notebookId]/paragraph/[paragraphId] Success code 200 Fail code 500 sample JSON response {&quot;status&quot;: &quot;OK&quot;,&quot;message&quot;: &quot;&quot;} Export a notebook Description This GET method exports a notebook by the given id and gernerates a JSON URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/export/[notebookId] Success code 201 Fail code 500 sample JSON response { &quot;paragraphs&quot;: [ { &quot;text&quot;: &quot;%md This is my new paragraph in my new note&quot;, &qu ot;dateUpdated&quot;: &quot;Jan 8, 2016 4:49:38 PM&quot;, &quot;config&quot;: { &quot;enabled&quot;: true }, &quot;settings&quot;: { &quot;params&quot;: {}, &quot;forms&quot;: {} }, &quot;jobName&quot;: &quot;paragraph_1452300578795_1196072540&quot;, &quot;id&quot;: &quot;20160108-164938_1685162144&quot;, &quot;dateCreated&quot;: &quot;Jan 8, 2016 4:49:38 PM&quot;, &quot;status&quot;: &quot;READY&quot;, &quot;progressUpdateIntervalMs&quot;: 500 } ], &quot;name&quot;: &quot;source note for export&quot;, &quot;id&quot;: &quot;2B82H3RR1&quot;, &quot;angularObjects&quot;: {}, &quot;config&quot;: {}, &quot;info&quot;: {}} Import a notebook Description This POST method imports a notebook from the notebook JSON input URL http://[zeppelin-server]:[zeppelin-port]/api/notebook/import Success code 201 Fail code 500 sample JSON input { &quot;paragraphs&quot;: [ { &quot;text&quot;: &quot;%md This is my new paragraph in my new note&quot;, &quot;dateUpdated&quot;: &quot;Jan 8, 2016 4:49:38 PM&quot;, &quot;config&quot;: { &quot;enabled&quot;: true }, &quot;settings&quot;: { &quot;params&quot;: {}, &quot;forms&quot;: {} }, &quot;jobName&quot;: &quot;paragraph_1452300578795_1196072540&quot;, &quot;id&quot;: &quot;20160108-164938_1685162144&quot;, &quot;dateCreated&quot;: &quot;Jan 8, 2016 4:49:38 PM&quot;, &quot;status&quot;: &quot;READY&quot;, &quot;progressUpdateIntervalMs&quot;: 500 } ], &quo t;name&quot;: &quot;source note for export&quot;, &quot;id&quot;: &quot;2B82H3RR1&quot;, &quot;angularObjects&quot;: {}, &quot;config&quot;: {}, &quot;info&quot;: {}} sample JSON response { &quot;status&quot;: &quot;CREATED&quot;, &quot;message&quot;: &quot;&quot;, &quot;body&quot;: &quot;2AZPHY918&quot;} ", [... 40 lines stripped ...] Modified: zeppelin/site/docs/0.7.0-SNAPSHOT/security/authentication.html URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.0-SNAPSHOT/security/authentication.html?rev=1760292&r1=1760291&r2=1760292&view=diff ============================================================================== --- zeppelin/site/docs/0.7.0-SNAPSHOT/security/authentication.html (original) +++ zeppelin/site/docs/0.7.0-SNAPSHOT/security/authentication.html Mon Sep 12 04:31:10 2016 @@ -152,6 +152,8 @@ <li class="title"><span><b>Advanced</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li> <li role="separator" class="divider"></li> <li class="title"><span><b>Contibute</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li> Modified: zeppelin/site/docs/0.7.0-SNAPSHOT/security/datasource_authorization.html URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.0-SNAPSHOT/security/datasource_authorization.html?rev=1760292&r1=1760291&r2=1760292&view=diff ============================================================================== --- zeppelin/site/docs/0.7.0-SNAPSHOT/security/datasource_authorization.html (original) +++ zeppelin/site/docs/0.7.0-SNAPSHOT/security/datasource_authorization.html Mon Sep 12 04:31:10 2016 @@ -152,6 +152,8 @@ <li class="title"><span><b>Advanced</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li> <li role="separator" class="divider"></li> <li class="title"><span><b>Contibute</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li> Modified: zeppelin/site/docs/0.7.0-SNAPSHOT/security/notebook_authorization.html URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.0-SNAPSHOT/security/notebook_authorization.html?rev=1760292&r1=1760291&r2=1760292&view=diff ============================================================================== --- zeppelin/site/docs/0.7.0-SNAPSHOT/security/notebook_authorization.html (original) +++ zeppelin/site/docs/0.7.0-SNAPSHOT/security/notebook_authorization.html Mon Sep 12 04:31:10 2016 @@ -152,6 +152,8 @@ <li class="title"><span><b>Advanced</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li> <li role="separator" class="divider"></li> <li class="title"><span><b>Contibute</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li> Modified: zeppelin/site/docs/0.7.0-SNAPSHOT/security/shiroauthentication.html URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.0-SNAPSHOT/security/shiroauthentication.html?rev=1760292&r1=1760291&r2=1760292&view=diff ============================================================================== --- zeppelin/site/docs/0.7.0-SNAPSHOT/security/shiroauthentication.html (original) +++ zeppelin/site/docs/0.7.0-SNAPSHOT/security/shiroauthentication.html Mon Sep 12 04:31:10 2016 @@ -152,6 +152,8 @@ <li class="title"><span><b>Advanced</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li> <li role="separator" class="divider"></li> <li class="title"><span><b>Contibute</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li> @@ -281,13 +283,30 @@ To learn more about Apache Shiro Realm, <p>We also provide community custom Realms.</p> <h3>Active Directory</h3> +<div class="highlight"><pre><code class="text language-text" data-lang="text">activeDirectoryRealm = org.apache.zeppelin.server.ActiveDirectoryGroupRealm +activeDirectoryRealm.systemUsername = userNameA +activeDirectoryRealm.systemPassword = passwordA +activeDirectoryRealm.hadoopSecurityCredentialPath = jceks://file/user/zeppelin/conf/zeppelin.jceks +activeDirectoryRealm.searchBase = CN=Users,DC=SOME_GROUP,DC=COMPANY,DC=COM +activeDirectoryRealm.url = ldap://ldap.test.com:389 +activeDirectoryRealm.groupRolesMap = "CN=aGroupName,OU=groups,DC=SOME_GROUP,DC=COMPANY,DC=COM":"group1" +activeDirectoryRealm.authorizationCachingEnabled = false +</code></pre></div> +<p>Also instead of specifying systemPassword in clear text in shiro.ini administrator can choose to specify the same in "hadoop credential". +Create a keystore file using the hadoop credential commandline, for this the hadoop commons should be in the classpath +<code>hadoop credential create activeDirectoryRealm.systempassword -provider jceks://file/user/zeppelin/conf/zeppelin.jceks</code></p> -<p>TBD</p> +<p>Change the following values in the Shiro.ini file, and uncomment the line: +<code>activeDirectoryRealm.hadoopSecurityCredentialPath = jceks://file/user/zeppelin/conf/zeppelin.jceks</code></p> <h3>LDAP</h3> - -<p>TBD</p> - +<div class="highlight"><pre><code class="text language-text" data-lang="text">ldapRealm = org.apache.zeppelin.server.LdapGroupRealm +# search base for ldap groups (only relevant for LdapGroupRealm): +ldapRealm.contextFactory.environment[ldap.searchBase] = dc=COMPANY,dc=COM +ldapRealm.contextFactory.url = ldap://ldap.test.com:389 +ldapRealm.userDnTemplate = uid={0},ou=Users,dc=COMPANY,dc=COM +ldapRealm.contextFactory.authenticationMechanism = SIMPLE +</code></pre></div> <h3>ZeppelinHub</h3> <p><a href="https://www.zeppelinhub.com";>ZeppelinHub</a> is a service that synchronize your Apache Zeppelin notebooks and enables you to collaborate easily.</p> Modified: zeppelin/site/docs/0.7.0-SNAPSHOT/storage/storage.html URL: http://svn.apache.org/viewvc/zeppelin/site/docs/0.7.0-SNAPSHOT/storage/storage.html?rev=1760292&r1=1760291&r2=1760292&view=diff ============================================================================== --- zeppelin/site/docs/0.7.0-SNAPSHOT/storage/storage.html (original) +++ zeppelin/site/docs/0.7.0-SNAPSHOT/storage/storage.html Mon Sep 12 04:31:10 2016 @@ -152,6 +152,8 @@ <li class="title"><span><b>Advanced</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/virtual_machine.html">Zeppelin on Vagrant VM</a></li> <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-standalone-mode">Zeppelin on Spark Cluster Mode (Standalone)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-yarn-mode">Zeppelin on Spark Cluster Mode (YARN)</a></li> + <li><a href="/docs/0.7.0-SNAPSHOT/install/spark_cluster_mode.html#spark-on-mesos-mode">Zeppelin on Spark Cluster Mode (Mesos)</a></li> <li role="separator" class="divider"></li> <li class="title"><span><b>Contibute</b><span></li> <li><a href="/docs/0.7.0-SNAPSHOT/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li>
