Added: incubator/zeppelin/site/docs/0.5.6-incubating/install/install.html URL: http://svn.apache.org/viewvc/incubator/zeppelin/site/docs/0.5.6-incubating/install/install.html?rev=1726359&view=auto ============================================================================== --- incubator/zeppelin/site/docs/0.5.6-incubating/install/install.html (added) +++ incubator/zeppelin/site/docs/0.5.6-incubating/install/install.html Sat Jan 23 08:45:18 2016 @@ -0,0 +1,369 @@ + +<!DOCTYPE html> +<html lang="en"> + <head> + <meta charset="utf-8"> + <title>Install Zeppelin</title> + <meta name="description" content=""> + <meta name="author" content="The Apache Software Foundation"> + + <!-- Enable responsive viewport --> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <!-- Le HTML5 shim, for IE6-8 support of HTML elements --> + <!--[if lt IE 9]> + <script src="http://html5shim.googlecode.com/svn/trunk/html5.js";></script> + <![endif]--> + + <!-- Le styles --> + <link href="/docs/0.5.6-incubating/assets/themes/zeppelin/bootstrap/css/bootstrap.css" rel="stylesheet"> + <link href="/docs/0.5.6-incubating/assets/themes/zeppelin/css/style.css?body=1" rel="stylesheet" type="text/css"> + <link href="/docs/0.5.6-incubating/assets/themes/zeppelin/css/syntax.css" rel="stylesheet" type="text/css" media="screen" /> + <!-- Le fav and touch icons --> + <!-- Update these with your own images + <link rel="shortcut icon" href="images/favicon.ico"> + <link rel="apple-touch-icon" href="images/apple-touch-icon.png"> + <link rel="apple-touch-icon" sizes="72x72" href="images/apple-touch-icon-72x72.png"> + <link rel="apple-touch-icon" sizes="114x114" href="images/apple-touch-icon-114x114.png"> + --> + + <!-- Js --> + <script src="https://code.jquery.com/jquery-1.10.2.min.js";></script> + <script src="/docs/0.5.6-incubating/assets/themes/zeppelin/bootstrap/js/bootstrap.min.js"></script> + <script src="/docs/0.5.6-incubating/assets/themes/zeppelin/js/docs.js"></script> + + <!-- atom & rss feed --> + <link href="/docs/0.5.6-incubating/atom.xml" type="application/atom+xml" rel="alternate" title="Sitewide ATOM Feed"> + <link href="/docs/0.5.6-incubating/rss.xml" type="application/rss+xml" rel="alternate" title="Sitewide RSS Feed"> + </head> + + <body> + + <div id="menu" class="navbar navbar-inverse navbar-fixed-top" role="navigation"> + <div class="container"> + <div class="navbar-header"> + <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/docs/0.5.6-incubating"> + <img src="/assets/themes/zeppelin/img/zeppelin_logo.png" width="50" alt="I'm zeppelin"> + <span style="vertical-align:middle">Zeppelin</span> + <span style="vertical-align:baseline"><small>(0.5.6-incubating)</small></span> + </a> + </div> + <nav class="navbar-collapse collapse" role="navigation"> + <ul class="nav navbar-nav"> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">Quick Start <b class="caret"></b></a> + <ul class="dropdown-menu"> + <!-- li><span><b>Overview</b><span></li --> + <li><a href="/docs/0.5.6-incubating/index.html">Overview</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Install</b><span></li --> + <li><a href="/docs/0.5.6-incubating/install/install.html">Install</a></li> + <li><a href="/docs/0.5.6-incubating/install/yarn_install.html">YARN Install</a></li> + <li><a href="/docs/0.5.6-incubating/install/virtual_machine.html">Virtual Machine Install</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Tutorial</b><span></li --> + <li><a href="/docs/0.5.6-incubating/tutorial/tutorial.html">Tutorial</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Guide</b><span></li --> + <li><a href="/docs/0.5.6-incubating/manual/dynamicform.html">Dynamic Form</a></li> + </ul> + </li> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">Interpreter <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="/docs/0.5.6-incubating/manual/interpreters.html">Overview</a></li> + <li role="separator" class="divider"></li> + <li><a href="/docs/0.5.6-incubating/interpreter/cassandra.html">Cassandra</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/elasticsearch.html">Elasticsearch</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/flink.html">Flink</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/geode.html">Geode</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/hive.html">Hive</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/ignite.html">Ignite</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/lens.html">Lens</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/markdown.html">Markdown</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/postgresql.html">Postgresql, hawq</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/scalding.html">Scalding</a></li> + <li><a href="/docs/0.5.6-incubating/pleasecontribute.html">Shell</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/spark.html">Spark</a></li> + <li><a href="/docs/0.5.6-incubating/pleasecontribute.html">Tajo</a></li> + </ul> + </li> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">Display System <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="/docs/0.5.6-incubating/displaysystem/display.html">Text</a></li> + <li><a href="/docs/0.5.6-incubating/displaysystem/display.html#html">Html</a></li> + <li><a href="/docs/0.5.6-incubating/displaysystem/table.html">Table</a></li> + <li><a href="/docs/0.5.6-incubating/displaysystem/angular.html">Angular</a></li> + </ul> + </li> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">More <b class="caret"></b></a> + <ul class="dropdown-menu"> + <!-- li><span><b>Manual</b><span></li --> + <li><a href="/docs/0.5.6-incubating/manual/notebookashomepage.html">Notebook as Homepage</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Notebook Storage</b><span></li --> + <li><a href="/docs/0.5.6-incubating/storage/storage.html#Git">Git Storage</a></li> + <li><a href="/docs/0.5.6-incubating/storage/storage.html#S3">S3 Storage</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>REST API</b><span></li --> + <li><a href="/docs/0.5.6-incubating/rest-api/rest-interpreter.html">Interpreter API</a></li> + <li><a href="/docs/0.5.6-incubating/rest-api/rest-notebook.html">Notebook API</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Development</b><span></li --> + <li><a href="/docs/0.5.6-incubating/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li> + <li><a href="/docs/0.5.6-incubating/development/howtocontribute.html">How to contribute (code)</a></li> + <li><a href="/docs/0.5.6-incubating/development/howtocontributewebsite.html">How to contribute (website)</a></li> + </ul> + </li> + </ul> + </nav><!--/.navbar-collapse --> + </div> + </div> + + + <div class="container"> + +<!--<div class="hero-unit Install Zeppelin"> + <h1></h1> +</div> +--> + +<div class="row"> + <div class="col-md-12"> + <!-- +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 at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed 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 and +limitations under the License. +--> + +<h2>From binary package</h2> + +<p>Download latest binary package from <a href="../download.html">Download</a>.</p> + +<h2>Build from source</h2> + +<p>Check instructions in <a href="https://github.com/apache/incubator-zeppelin/blob/master/README.md";>README</a> to build from source.</p> + +<h2>Configure</h2> + +<p>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.</p> + +<table class="table-configuration"> + <tr> + <th>zepplin-env.sh</th> + <th>zepplin-site.xml</th> + <th>Default value</th> + <th>Description</th> + </tr> + <tr> + <td>ZEPPELIN_PORT</td> + <td>zeppelin.server.port</td> + <td>8080</td> + <td>Zeppelin server port.</td> + </tr> + <tr> + <td>ZEPPELIN_MEM</td> + <td>N/A</td> + <td>-Xmx1024m -XX:MaxPermSize=512m</td> + <td>JVM mem options</td> + </tr> + <tr> + <td>ZEPPELIN_INTP_MEM</td> + <td>N/A</td> + <td>ZEPPELIN_MEM</td> + <td>JVM mem options for interpreter process</td> + </tr> + <tr> + <td>ZEPPELIN_JAVA_OPTS</td> + <td>N/A</td> + <td></td> + <td>JVM Options</td> + </tr> + <tr> + <td>ZEPPELIN_ALLOWED_ORIGINS</td> + <td>zeppelin.server.allowed.origins</td> + <td>*</td> + <td>Allows a way to specify a ',' separated list of allowed origins for rest and websockets. i.e. http://localhost:8080</td> + </tr> + <tr> + <td>ZEPPELIN_SERVER_CONTEXT_PATH</td> + <td>zeppelin.server.context.path</td> + <td>/</td> + <td>Context Path of the Web Application</td> + </tr> + <tr> + <td>ZEPPELIN_SSL</td> + <td>zeppelin.ssl</td> + <td>false</td> + <td></td> + </tr> + <tr> + <td>ZEPPELIN_SSL_CLIENT_AUTH</td> + <td>zeppelin.ssl.client.auth</td> + <td>false</td> + <td></td> + </tr> + <tr> + <td>ZEPPELIN_SSL_KEYSTORE_PATH</td> + <td>zeppelin.ssl.keystore.path</td> + <td>keystore</td> + <td></td> + </tr> + <tr> + <td>ZEPPELIN_SSL_KEYSTORE_TYPE</td> + <td>zeppelin.ssl.keystore.type</td> + <td>JKS</td> + <td></td> + </tr> + <tr> + <td>ZEPPELIN_SSL_KEYSTORE_PASSWORD</td> + <td>zeppelin.ssl.keystore.password</td> + <td></td> + <td></td> + </tr> + <tr> + <td>ZEPPELIN_SSL_KEY_MANAGER_PASSWORD</td> + <td>zeppelin.ssl.key.manager.password</td> + <td></td> + <td></td> + </tr> + <tr> + <td>ZEPPELIN_SSL_TRUSTSTORE_PATH</td> + <td>zeppelin.ssl.truststore.path</td> + <td></td> + <td></td> + </tr> + <tr> + <td>ZEPPELIN_SSL_TRUSTSTORE_TYPE</td> + <td>zeppelin.ssl.truststore.type</td> + <td></td> + <td></td> + </tr> + <tr> + <td>ZEPPELIN_SSL_TRUSTSTORE_PASSWORD</td> + <td>zeppelin.ssl.truststore.password</td> + <td></td> + <td></td> + </tr> + <tr> + <td>ZEPPELIN_NOTEBOOK_HOMESCREEN</td> + <td>zeppelin.notebook.homescreen</td> + <td></td> + <td>Id of notebook to be displayed in homescreen ex) 2A94M5J1Z</td> + </tr> + <tr> + <td>ZEPPELIN_NOTEBOOK_HOMESCREEN_HIDE</td> + <td>zeppelin.notebook.homescreen.hide</td> + <td>false</td> + <td>hide homescreen notebook from list when this value set to "true"</td> + </tr> + <tr> + <td>ZEPPELIN_WAR_TEMPDIR</td> + <td>zeppelin.war.tempdir</td> + <td>webapps</td> + <td>The location of jetty temporary directory.</td> + </tr> + <tr> + <td>ZEPPELIN_NOTEBOOK_DIR</td> + <td>zeppelin.notebook.dir</td> + <td>notebook</td> + <td>Where notebook file is saved</td> + </tr> + <tr> + <td>ZEPPELIN_NOTEBOOK_S3_BUCKET</td> + <td>zeppelin.notebook.s3.bucket</td> + <td>zeppelin</td> + <td>Bucket where notebook saved</td> + </tr> + <tr> + <td>ZEPPELIN_NOTEBOOK_S3_USER</td> + <td>zeppelin.notebook.s3.user</td> + <td>user</td> + <td>User in bucket where notebook saved. For example bucket/user/notebook/2A94M5J1Z/note.json</td> + </tr> + <tr> + <td>ZEPPELIN_NOTEBOOK_STORAGE</td> + <td>zeppelin.notebook.storage</td> + <td>org.apache.zeppelin.notebook.repo.VFSNotebookRepo</td> + <td>Comma separated list of notebook storage</td> + </tr> + <tr> + <td>ZEPPELIN_INTERPRETERS</td> + <td>zeppelin.interpreters</td> + <description></description> + <td>org.apache.zeppelin.spark.SparkInterpreter,<br />org.apache.zeppelin.spark.PySparkInterpreter,<br />org.apache.zeppelin.spark.SparkSqlInterpreter,<br />org.apache.zeppelin.spark.DepInterpreter,<br />org.apache.zeppelin.markdown.Markdown,<br />org.apache.zeppelin.shell.ShellInterpreter,<br />org.apache.zeppelin.hive.HiveInterpreter<br /> + ... + </td> + <td>Comma separated interpreter configurations [Class]. First interpreter become a default</td> + </tr> + <tr> + <td>ZEPPELIN_INTERPRETER_DIR</td> + <td>zeppelin.interpreter.dir</td> + <td>interpreter</td> + <td>Zeppelin interpreter directory</td> + </tr> +</table> + +<p><br /> +You'll also need to configure individual interpreter. Information can be found in 'Interpreter' section in this documentation.</p> + +<p>For example <a href="../interpreter/spark.html">Spark</a>.</p> + +<p><br /></p> + +<h2>Start/Stop</h2> + +<h4>Start Zeppelin</h4> +<div class="highlight"><pre><code class="text language-text" data-lang="text">bin/zeppelin-daemon.sh start +</code></pre></div> +<p>After successful start, visit http://localhost:8080 with your web browser.</p> + +<h4>Stop Zeppelin</h4> +<div class="highlight"><pre><code class="text language-text" data-lang="text">bin/zeppelin-daemon.sh stop +</code></pre></div> + </div> +</div> + + + <hr> + <footer> + <!-- <p>© 2016 The Apache Software Foundation</p>--> + </footer> + </div> + + + + + <script type="text/javascript"> + (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ + (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), + m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) + })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); + + ga('create', 'UA-45176241-5', 'zeppelin.incubator.apache.org'); + ga('require', 'linkid', 'linkid.js'); + ga('send', 'pageview'); + +</script> + + + + </body> +</html> +
Added: incubator/zeppelin/site/docs/0.5.6-incubating/install/virtual_machine.html URL: http://svn.apache.org/viewvc/incubator/zeppelin/site/docs/0.5.6-incubating/install/virtual_machine.html?rev=1726359&view=auto ============================================================================== --- incubator/zeppelin/site/docs/0.5.6-incubating/install/virtual_machine.html (added) +++ incubator/zeppelin/site/docs/0.5.6-incubating/install/virtual_machine.html Sat Jan 23 08:45:18 2016 @@ -0,0 +1,320 @@ + +<!DOCTYPE html> +<html lang="en"> + <head> + <meta charset="utf-8"> + <title>Install A Zeppelin ready Virtual Machine</title> + <meta name="description" content=""> + <meta name="author" content="The Apache Software Foundation"> + + <!-- Enable responsive viewport --> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <!-- Le HTML5 shim, for IE6-8 support of HTML elements --> + <!--[if lt IE 9]> + <script src="http://html5shim.googlecode.com/svn/trunk/html5.js";></script> + <![endif]--> + + <!-- Le styles --> + <link href="/docs/0.5.6-incubating/assets/themes/zeppelin/bootstrap/css/bootstrap.css" rel="stylesheet"> + <link href="/docs/0.5.6-incubating/assets/themes/zeppelin/css/style.css?body=1" rel="stylesheet" type="text/css"> + <link href="/docs/0.5.6-incubating/assets/themes/zeppelin/css/syntax.css" rel="stylesheet" type="text/css" media="screen" /> + <!-- Le fav and touch icons --> + <!-- Update these with your own images + <link rel="shortcut icon" href="images/favicon.ico"> + <link rel="apple-touch-icon" href="images/apple-touch-icon.png"> + <link rel="apple-touch-icon" sizes="72x72" href="images/apple-touch-icon-72x72.png"> + <link rel="apple-touch-icon" sizes="114x114" href="images/apple-touch-icon-114x114.png"> + --> + + <!-- Js --> + <script src="https://code.jquery.com/jquery-1.10.2.min.js";></script> + <script src="/docs/0.5.6-incubating/assets/themes/zeppelin/bootstrap/js/bootstrap.min.js"></script> + <script src="/docs/0.5.6-incubating/assets/themes/zeppelin/js/docs.js"></script> + + <!-- atom & rss feed --> + <link href="/docs/0.5.6-incubating/atom.xml" type="application/atom+xml" rel="alternate" title="Sitewide ATOM Feed"> + <link href="/docs/0.5.6-incubating/rss.xml" type="application/rss+xml" rel="alternate" title="Sitewide RSS Feed"> + </head> + + <body> + + <div id="menu" class="navbar navbar-inverse navbar-fixed-top" role="navigation"> + <div class="container"> + <div class="navbar-header"> + <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/docs/0.5.6-incubating"> + <img src="/assets/themes/zeppelin/img/zeppelin_logo.png" width="50" alt="I'm zeppelin"> + <span style="vertical-align:middle">Zeppelin</span> + <span style="vertical-align:baseline"><small>(0.5.6-incubating)</small></span> + </a> + </div> + <nav class="navbar-collapse collapse" role="navigation"> + <ul class="nav navbar-nav"> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">Quick Start <b class="caret"></b></a> + <ul class="dropdown-menu"> + <!-- li><span><b>Overview</b><span></li --> + <li><a href="/docs/0.5.6-incubating/index.html">Overview</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Install</b><span></li --> + <li><a href="/docs/0.5.6-incubating/install/install.html">Install</a></li> + <li><a href="/docs/0.5.6-incubating/install/yarn_install.html">YARN Install</a></li> + <li><a href="/docs/0.5.6-incubating/install/virtual_machine.html">Virtual Machine Install</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Tutorial</b><span></li --> + <li><a href="/docs/0.5.6-incubating/tutorial/tutorial.html">Tutorial</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Guide</b><span></li --> + <li><a href="/docs/0.5.6-incubating/manual/dynamicform.html">Dynamic Form</a></li> + </ul> + </li> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">Interpreter <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="/docs/0.5.6-incubating/manual/interpreters.html">Overview</a></li> + <li role="separator" class="divider"></li> + <li><a href="/docs/0.5.6-incubating/interpreter/cassandra.html">Cassandra</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/elasticsearch.html">Elasticsearch</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/flink.html">Flink</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/geode.html">Geode</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/hive.html">Hive</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/ignite.html">Ignite</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/lens.html">Lens</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/markdown.html">Markdown</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/postgresql.html">Postgresql, hawq</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/scalding.html">Scalding</a></li> + <li><a href="/docs/0.5.6-incubating/pleasecontribute.html">Shell</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/spark.html">Spark</a></li> + <li><a href="/docs/0.5.6-incubating/pleasecontribute.html">Tajo</a></li> + </ul> + </li> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">Display System <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="/docs/0.5.6-incubating/displaysystem/display.html">Text</a></li> + <li><a href="/docs/0.5.6-incubating/displaysystem/display.html#html">Html</a></li> + <li><a href="/docs/0.5.6-incubating/displaysystem/table.html">Table</a></li> + <li><a href="/docs/0.5.6-incubating/displaysystem/angular.html">Angular</a></li> + </ul> + </li> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">More <b class="caret"></b></a> + <ul class="dropdown-menu"> + <!-- li><span><b>Manual</b><span></li --> + <li><a href="/docs/0.5.6-incubating/manual/notebookashomepage.html">Notebook as Homepage</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Notebook Storage</b><span></li --> + <li><a href="/docs/0.5.6-incubating/storage/storage.html#Git">Git Storage</a></li> + <li><a href="/docs/0.5.6-incubating/storage/storage.html#S3">S3 Storage</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>REST API</b><span></li --> + <li><a href="/docs/0.5.6-incubating/rest-api/rest-interpreter.html">Interpreter API</a></li> + <li><a href="/docs/0.5.6-incubating/rest-api/rest-notebook.html">Notebook API</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Development</b><span></li --> + <li><a href="/docs/0.5.6-incubating/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li> + <li><a href="/docs/0.5.6-incubating/development/howtocontribute.html">How to contribute (code)</a></li> + <li><a href="/docs/0.5.6-incubating/development/howtocontributewebsite.html">How to contribute (website)</a></li> + </ul> + </li> + </ul> + </nav><!--/.navbar-collapse --> + </div> + </div> + + + <div class="container"> + +<!--<div class="hero-unit Install A Zeppelin ready Virtual Machine"> + <h1></h1> +</div> +--> + +<div class="row"> + <div class="col-md-12"> + <!-- +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 at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed 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 and +limitations under the License. +--> + +<h2>Vagrant Virtual Machine for Apache Zeppelin</h2> + +<p>The Apache Zeppelin distribution includes a scripts directory</p> + +<p><code>scripts/vagrant/zeppelin-dev</code></p> + +<p>This script creates a virtual machine that launches a repeatable, known set of core dependencies required for developing Zeppelin. It can also be used to run an existing Zeppelin build if you don't plan to build from source. For pyspark users, this script also includes several helpful <a href="#pythonextras">Python Libraries</a></p> + +<h4>Installing the required components to launch a virtual machine.</h4> + +<p>This script requires three applications, <a href="http://docs.ansible.com/ansible/intro_installation.html#latest-releases-via-pip"; title="Ansible">Ansible</a>, <a href="http://www.vagrantup.com/downloads"; title="Vagrant">Vagrant</a> and <a href="https://www.virtualbox.org/"; title="Virtual Box">Virtual Box</a>. All of these applications are freely available as Open Source projects and extremely easy to set up on most operating systems.</p> + +<h3>Create a Zeppelin Ready VM in 4 Steps (5 on Windows)</h3> + +<p><em>If you are running Windows and don't yet have python installed, install Python 2.7.x</em> <a href="https://www.python.org/downloads/release/python-2710/";>Python Windows Installer</a></p> + +<ol> +<li>Download and Install Vagrant: <a href="http://www.vagrantup.com/downloads";>Vagrant Downloads</a></li> +<li>Install Ansible: <a href="http://docs.ansible.com/ansible/intro_installation.html#latest-releases-via-pip";>Ansible Python pip install</a><br> +<code>sudo easy_install pip</code> then<br> +<code>sudo pip install ansible</code><br> +<code>ansible --version</code> should now report version 1.9.2 or higher</li> +<li>Install Virtual Box: <a href="https://www.virtualbox.org/"; title="Virtual Box">Virtual Box Downloads</a></li> +<li>Type <code>vagrant up</code> from within the <code>/scripts/vagrant/zeppelin-dev</code> directory</li> +</ol> + +<p>Thats it!</p> + +<p>You can now run <code>vagrant ssh</code> and this will place you into the guest machines terminal prompt.</p> + +<p>If you don't wish to build Zeppelin from scratch, run the z-manager installer script while running in the guest VM:</p> +<div class="highlight"><pre><code class="text language-text" data-lang="text">curl -fsSL https://raw.githubusercontent.com/NFLabs/z-manager/master/zeppelin-installer.sh | bash +</code></pre></div> +<h3>Building Zeppelin</h3> + +<p>You can now <code>git clone https://github.com/apache/incubator-zeppelin.git</code> into a directory on your host machine, or directly in your virtual machine.</p> + +<p>Cloning zeppelin into the <code>/scripts/vagrant/zeppelin-dev</code> directory from the host, will allow the directory to be shared between your host and the guest machine.</p> + +<p>Cloning the project again may seem counter intuitive, since this script likley originated from the project repository. Consider copying just the vagrant/zeppelin-dev script from the zeppelin project as a stand alone directory, then once again clone the specific branch you wish to build.</p> + +<p>Synced folders enable Vagrant to sync a folder on the host machine to the guest machine, allowing you to continue working on your project's files on your host machine, but use the resources in the guest machine to compile or run your project. <em><a href="https://docs.vagrantup.com/v2/synced-folders/index.html";>(1) Synced Folder Description from Vagrant Up</a></em></p> + +<p>By default, Vagrant will share your project directory (the directory with the Vagrantfile) to <code>/vagrant</code>. Which means you should be able to build within the guest machine after you<br> +<code>cd /vagrant/incubator-zeppelin</code></p> + +<h3>What's in this VM?</h3> + +<p>Running the following commands in the guest machine should display these expected versions:</p> + +<p><code>node --version</code> should report <em>v0.12.7</em><br> +<code>mvn --version</code> should report <em>Apache Maven 3.3.3</em> and <em>Java version: 1.7.0_85</em></p> + +<p>The virtual machine consists of:</p> + +<ul> +<li>Ubuntu Server 14.04 LTS</li> +<li>Node.js 0.12.7</li> +<li>npm 2.11.3</li> +<li>ruby 1.9.3 + rake, make and bundler (only required if building jekyll documentation)</li> +<li>Maven 3.3.3</li> +<li>Git</li> +<li>Unzip</li> +<li>libfontconfig to avoid phatomJs missing dependency issues</li> +<li>openjdk-7-jdk</li> +<li>Python addons: pip, matplotlib, scipy, numpy, pandas</li> +</ul> + +<h3>How to build & run Zeppelin</h3> + +<p>This assumes you've already cloned the project either on the host machine in the zeppelin-dev directory (to be shared with the guest machine) or cloned directly into a directory while running inside the guest machine.</p> +<div class="highlight"><pre><code class="text language-text" data-lang="text">cd /incubator-zeppelin +mvn clean package -Pspark-1.5 -Ppyspark -Dhadoop.version=2.2.0 -Phadoop-2.2 -DskipTests +./bin/zeppelin-daemon.sh start +</code></pre></div> +<p>On your host machine browse to <code>http://localhost:8080/</code></p> + +<p>If you <a href="#tweakvm">turned off port forwarding</a> in the <code>Vagrantfile</code> browse to <code>http://192.168.51.52:8080</code></p> + +<h3><a href="id:tweakvm">Tweaking the Virtual Machine</a></h3> + +<p>If you plan to run this virtual machine along side other Vagrant images, you may wish to bind the virtual machine to a specific IP address, and not use port fowarding from your local host.</p> + +<p>Comment out the <code>forward_port</code> line, and uncomment the <code>private_network</code> line in Vagrantfile. The subnet that works best for your local network will vary so adjust <code>192.168.*.*</code> accordingly.</p> +<div class="highlight"><pre><code class="text language-text" data-lang="text">#config.vm.network "forwarded_port", guest: 8080, host: 8080 +config.vm.network "private_network", ip: "192.168.51.52" +</code></pre></div> +<p><code>vagrant halt</code> followed by <code>vagrant up</code> will restart the guest machine bound to the IP address of <code>192.168.51.52</code>.<br> +This approach usually is typically required if running other virtual machines that discover each other directly by IP address, such as Spark Masters and Slaves as well as Cassandra Nodes, Elasticsearch Nodes, and other Spark data sources. You may wish to launch nodes in virtual machines with IP Addresses in a subnet that works for your local network, such as: 192.168.51.53, 192.168.51.54, 192.168.51.53, etc..</p> + +<h3><a href="id:pythonextras">Python Extras</a></h3> + +<p>With zeppelin running, Numpy, SciPy, Pandas and Matplotlib will be available. Create a pyspark notebook, and try</p> +<div class="highlight"><pre><code class="text language-text" data-lang="text">%pyspark + +import numpy +import scipy +import pandas +import matplotlib + +print "numpy " + numpy.__version__ +print "scipy " + scipy.__version__ +print "pandas " + pandas.__version__ +print "matplotlib " + matplotlib.__version__ +</code></pre></div> +<p>To Test plotting using matplotlib into a rendered %html SVG image, try</p> +<div class="highlight"><pre><code class="text language-text" data-lang="text">%pyspark + +import matplotlib +matplotlib.use('Agg') # turn off interactive charting so this works for server side SVG rendering +import matplotlib.pyplot as plt +import numpy as np +import StringIO + +# clear out any previous plots on this notebook +plt.clf() + +def show(p): + img = StringIO.StringIO() + p.savefig(img, format='svg') + img.seek(0) + print "%html <div style='width:600px'>" + img.buf + "</div>" + +# Example data +people = ('Tom', 'Dick', 'Harry', 'Slim', 'Jim') +y_pos = np.arange(len(people)) +performance = 3 + 10 * np.random.rand(len(people)) +error = np.random.rand(len(people)) + +plt.barh(y_pos, performance, xerr=error, align='center', alpha=0.4) +plt.yticks(y_pos, people) +plt.xlabel('Performance') +plt.title('How fast do you want to go today?') + +show(plt) +</code></pre></div> + </div> +</div> + + + <hr> + <footer> + <!-- <p>© 2016 The Apache Software Foundation</p>--> + </footer> + </div> + + + + + <script type="text/javascript"> + (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ + (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), + m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) + })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); + + ga('create', 'UA-45176241-5', 'zeppelin.incubator.apache.org'); + ga('require', 'linkid', 'linkid.js'); + ga('send', 'pageview'); + +</script> + + + + </body> +</html> + Added: incubator/zeppelin/site/docs/0.5.6-incubating/install/yarn_install.html URL: http://svn.apache.org/viewvc/incubator/zeppelin/site/docs/0.5.6-incubating/install/yarn_install.html?rev=1726359&view=auto ============================================================================== --- incubator/zeppelin/site/docs/0.5.6-incubating/install/yarn_install.html (added) +++ incubator/zeppelin/site/docs/0.5.6-incubating/install/yarn_install.html Sat Jan 23 08:45:18 2016 @@ -0,0 +1,394 @@ + +<!DOCTYPE html> +<html lang="en"> + <head> + <meta charset="utf-8"> + <title>Install Zeppelin to connect with existing YARN cluster</title> + <meta name="description" content=""> + <meta name="author" content="The Apache Software Foundation"> + + <!-- Enable responsive viewport --> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + + <!-- Le HTML5 shim, for IE6-8 support of HTML elements --> + <!--[if lt IE 9]> + <script src="http://html5shim.googlecode.com/svn/trunk/html5.js";></script> + <![endif]--> + + <!-- Le styles --> + <link href="/docs/0.5.6-incubating/assets/themes/zeppelin/bootstrap/css/bootstrap.css" rel="stylesheet"> + <link href="/docs/0.5.6-incubating/assets/themes/zeppelin/css/style.css?body=1" rel="stylesheet" type="text/css"> + <link href="/docs/0.5.6-incubating/assets/themes/zeppelin/css/syntax.css" rel="stylesheet" type="text/css" media="screen" /> + <!-- Le fav and touch icons --> + <!-- Update these with your own images + <link rel="shortcut icon" href="images/favicon.ico"> + <link rel="apple-touch-icon" href="images/apple-touch-icon.png"> + <link rel="apple-touch-icon" sizes="72x72" href="images/apple-touch-icon-72x72.png"> + <link rel="apple-touch-icon" sizes="114x114" href="images/apple-touch-icon-114x114.png"> + --> + + <!-- Js --> + <script src="https://code.jquery.com/jquery-1.10.2.min.js";></script> + <script src="/docs/0.5.6-incubating/assets/themes/zeppelin/bootstrap/js/bootstrap.min.js"></script> + <script src="/docs/0.5.6-incubating/assets/themes/zeppelin/js/docs.js"></script> + + <!-- atom & rss feed --> + <link href="/docs/0.5.6-incubating/atom.xml" type="application/atom+xml" rel="alternate" title="Sitewide ATOM Feed"> + <link href="/docs/0.5.6-incubating/rss.xml" type="application/rss+xml" rel="alternate" title="Sitewide RSS Feed"> + </head> + + <body> + + <div id="menu" class="navbar navbar-inverse navbar-fixed-top" role="navigation"> + <div class="container"> + <div class="navbar-header"> + <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse"> + <span class="sr-only">Toggle navigation</span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="navbar-brand" href="/docs/0.5.6-incubating"> + <img src="/assets/themes/zeppelin/img/zeppelin_logo.png" width="50" alt="I'm zeppelin"> + <span style="vertical-align:middle">Zeppelin</span> + <span style="vertical-align:baseline"><small>(0.5.6-incubating)</small></span> + </a> + </div> + <nav class="navbar-collapse collapse" role="navigation"> + <ul class="nav navbar-nav"> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">Quick Start <b class="caret"></b></a> + <ul class="dropdown-menu"> + <!-- li><span><b>Overview</b><span></li --> + <li><a href="/docs/0.5.6-incubating/index.html">Overview</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Install</b><span></li --> + <li><a href="/docs/0.5.6-incubating/install/install.html">Install</a></li> + <li><a href="/docs/0.5.6-incubating/install/yarn_install.html">YARN Install</a></li> + <li><a href="/docs/0.5.6-incubating/install/virtual_machine.html">Virtual Machine Install</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Tutorial</b><span></li --> + <li><a href="/docs/0.5.6-incubating/tutorial/tutorial.html">Tutorial</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Guide</b><span></li --> + <li><a href="/docs/0.5.6-incubating/manual/dynamicform.html">Dynamic Form</a></li> + </ul> + </li> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">Interpreter <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="/docs/0.5.6-incubating/manual/interpreters.html">Overview</a></li> + <li role="separator" class="divider"></li> + <li><a href="/docs/0.5.6-incubating/interpreter/cassandra.html">Cassandra</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/elasticsearch.html">Elasticsearch</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/flink.html">Flink</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/geode.html">Geode</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/hive.html">Hive</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/ignite.html">Ignite</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/lens.html">Lens</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/markdown.html">Markdown</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/postgresql.html">Postgresql, hawq</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/scalding.html">Scalding</a></li> + <li><a href="/docs/0.5.6-incubating/pleasecontribute.html">Shell</a></li> + <li><a href="/docs/0.5.6-incubating/interpreter/spark.html">Spark</a></li> + <li><a href="/docs/0.5.6-incubating/pleasecontribute.html">Tajo</a></li> + </ul> + </li> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">Display System <b class="caret"></b></a> + <ul class="dropdown-menu"> + <li><a href="/docs/0.5.6-incubating/displaysystem/display.html">Text</a></li> + <li><a href="/docs/0.5.6-incubating/displaysystem/display.html#html">Html</a></li> + <li><a href="/docs/0.5.6-incubating/displaysystem/table.html">Table</a></li> + <li><a href="/docs/0.5.6-incubating/displaysystem/angular.html">Angular</a></li> + </ul> + </li> + <li> + <a href="#" data-toggle="dropdown" class="dropdown-toggle">More <b class="caret"></b></a> + <ul class="dropdown-menu"> + <!-- li><span><b>Manual</b><span></li --> + <li><a href="/docs/0.5.6-incubating/manual/notebookashomepage.html">Notebook as Homepage</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Notebook Storage</b><span></li --> + <li><a href="/docs/0.5.6-incubating/storage/storage.html#Git">Git Storage</a></li> + <li><a href="/docs/0.5.6-incubating/storage/storage.html#S3">S3 Storage</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>REST API</b><span></li --> + <li><a href="/docs/0.5.6-incubating/rest-api/rest-interpreter.html">Interpreter API</a></li> + <li><a href="/docs/0.5.6-incubating/rest-api/rest-notebook.html">Notebook API</a></li> + <li role="separator" class="divider"></li> + <!-- li><span><b>Development</b><span></li --> + <li><a href="/docs/0.5.6-incubating/development/writingzeppelininterpreter.html">Writing Zeppelin Interpreter</a></li> + <li><a href="/docs/0.5.6-incubating/development/howtocontribute.html">How to contribute (code)</a></li> + <li><a href="/docs/0.5.6-incubating/development/howtocontributewebsite.html">How to contribute (website)</a></li> + </ul> + </li> + </ul> + </nav><!--/.navbar-collapse --> + </div> + </div> + + + <div class="container"> + +<!--<div class="hero-unit Install Zeppelin to connect with existing YARN cluster"> + <h1></h1> +</div> +--> + +<div class="row"> + <div class="col-md-12"> + <!-- +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 at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed 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 and +limitations under the License. +--> + +<h2>Introduction</h2> + +<p>This page describes how to pre-configure a bare metal node, build & configure Zeppelin on it, configure Zeppelin and connect it to existing YARN cluster running Hortonworks flavour of Hadoop. It also describes steps to configure Spark & Hive interpreter of Zeppelin. </p> + +<h2>Prepare Node</h2> + +<h3>Zeppelin user (Optional)</h3> + +<p>This step is optional, however its nice to run Zeppelin under its own user. In case you do not like to use Zeppelin (hope not) the user could be deleted along with all the pacakges that were installed for Zeppelin, Zeppelin binary itself and associated directories.</p> + +<p>Create a zeppelin user and switch to zeppelin user or if zeppelin user is already created then login as zeppelin.</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">useradd zeppelin +su - zeppelin +whoami +</code></pre></div> +<p>Assuming a zeppelin user is created then running whoami command must return </p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">zeppelin +</code></pre></div> +<p>Its assumed in the rest of the document that zeppelin user is indeed created and below installation instructions are performed as zeppelin user.</p> + +<h3>List of Prerequisites</h3> + +<ul> +<li>CentOS 6.x</li> +<li>Git</li> +<li>Java 1.7 </li> +<li>Apache Maven</li> +<li>Hadoop client.</li> +<li>Spark.</li> +<li>Internet connection is required. </li> +</ul> + +<p>Its assumed that the node has CentOS 6.x installed on it. Although any version of Linux distribution should work fine. The working directory of all prerequisite pacakges is /home/zeppelin/prerequisites, although any location could be used.</p> + +<h4>Git</h4> + +<p>Intall latest stable version of Git. This document describes installation of version 2.4.8</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel +yum install gcc perl-ExtUtils-MakeMaker +yum remove git +<span class="nb">cd</span> /home/zeppelin/prerequisites +wget https://github.com/git/git/archive/v2.4.8.tar.gz +tar xzf git-2.0.4.tar.gz +<span class="nb">cd </span>git-2.0.4 +make <span class="nv">prefix</span><span class="o">=</span>/home/zeppelin/prerequisites/git all +make <span class="nv">prefix</span><span class="o">=</span>/home/zeppelin/prerequisites/git install +<span class="nb">echo</span> <span class="s2">"export PATH=$PATH:/home/zeppelin/prerequisites/bin"</span> >> /home/zeppelin/.bashrc +<span class="nb">source</span> /home/zeppelin/.bashrc +git --version +</code></pre></div> +<p>Assuming all the packages are successfully installed, running the version option with git command should display</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">git version 2.4.8 +</code></pre></div> +<h4>Java</h4> + +<p>Zeppelin works well with 1.7.x version of Java runtime. Download JDK version 7 and a stable update and follow below instructions to install it.</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash"><span class="nb">cd</span> /home/zeppelin/prerequisites/ +<span class="c">#Download JDK 1.7, Assume JDK 7 update 79 is downloaded.</span> +tar -xf jdk-7u79-linux-x64.tar.gz +<span class="nb">echo</span> <span class="s2">"export JAVA_HOME=/home/zeppelin/prerequisites/jdk1.7.0_79"</span> >> /home/zeppelin/.bashrc +<span class="nb">source</span> /home/zeppelin/.bashrc +<span class="nb">echo</span> <span class="nv">$JAVA_HOME</span> +</code></pre></div> +<p>Assuming all the packages are successfully installed, echoing JAVA_HOME environment variable should display</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">/home/zeppelin/prerequisites/jdk1.7.0_79 +</code></pre></div> +<h4>Apache Maven</h4> + +<p>Download and install a stable version of Maven.</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash"><span class="nb">cd</span> /home/zeppelin/prerequisites/ +wget ftp://mirror.reverse.net/pub/apache/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz +tar -xf apache-maven-3.3.3-bin.tar.gz +<span class="nb">cd </span>apache-maven-3.3.3 +<span class="nb">export </span><span class="nv">MAVEN_HOME</span><span class="o">=</span>/home/zeppelin/prerequisites/apache-maven-3.3.3 +<span class="nb">echo</span> <span class="s2">"export PATH=$PATH:/home/zeppelin/prerequisites/apache-maven-3.3.3/bin"</span> >> /home/zeppelin/.bashrc +<span class="nb">source</span> /home/zeppelin/.bashrc +mvn -version +</code></pre></div> +<p>Assuming all the packages are successfully installed, running the version option with mvn command should display</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">Apache Maven 3.3.3 <span class="o">(</span>7994120775791599e205a5524ec3e0dfe41d4a06<span class="p">;</span> 2015-04-22T04:57:37-07:00<span class="o">)</span> +Maven home: /home/zeppelin/prerequisites/apache-maven-3.3.3 +Java version: 1.7.0_79, vendor: Oracle Corporation +Java home: /home/zeppelin/prerequisites/jdk1.7.0_79/jre +Default locale: en_US, platform encoding: UTF-8 +OS name: <span class="s2">"linux"</span>, version: <span class="s2">"2.6.32-358.el6.x86_64"</span>, arch: <span class="s2">"amd64"</span>, family: <span class="s2">"unix"</span> +</code></pre></div> +<h4>Hadoop client</h4> + +<p>Zeppelin can work with multiple versions & distributions of Hadoop. A complete list <a href="https://github.com/apache/incubator-zeppelin#build";>is available here.</a> This document assumes Hadoop 2.7.x client libraries including configuration files are installed on Zeppelin node. It also assumes /etc/hadoop/conf contains various Hadoop configuration files. The location of Hadoop configuration files may vary, hence use appropriate location.</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">hadoop version +Hadoop 2.7.1.2.3.1.0-2574 +Subversion [email protected]:hortonworks/hadoop.git -r f66cf95e2e9367a74b0ec88b2df33458b6cff2d0 +Compiled by jenkins on 2015-07-25T22:36Z +Compiled with protoc 2.5.0 +From <span class="nb">source </span>with checksum 54f9bbb4492f92975e84e390599b881d +This <span class="nb">command </span>was run using /usr/hdp/2.3.1.0-2574/hadoop/lib/hadoop-common-2.7.1.2.3.1.0-2574.jar +</code></pre></div> +<h4>Spark</h4> + +<p>Zeppelin can work with multiple versions Spark. A complete list <a href="https://github.com/apache/incubator-zeppelin#build";>is available here.</a> This document assumes Spark 1.3.1 is installed on Zeppelin node at /home/zeppelin/prerequisites/spark.</p> + +<h2>Build</h2> + +<p>Checkout source code from <a href="https://github.com/apache/incubator-zeppelin";>https://github.com/apache/incubator-zeppelin</a></p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash"><span class="nb">cd</span> /home/zeppelin/ +git clone https://github.com/apache/incubator-zeppelin.git +</code></pre></div> +<p>Zeppelin package is available at /home/zeppelin/incubator-zeppelin after the checkout completes.</p> + +<h3>Cluster mode</h3> + +<p>As its assumed Hadoop 2.7.x is installed on the YARN cluster & Spark 1.3.1 is installed on Zeppelin node. Hence appropriate options are chosen to build Zeppelin. This is very important as Zeppelin will bundle corresponding Hadoop & Spark libraries and they must match the ones present on YARN cluster & Zeppelin Spark installation. </p> + +<p>Zeppelin is a maven project and hence must be built with Apache Maven.</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash"><span class="nb">cd</span> /home/zeppelin/incubator-zeppelin +mvn clean package -Pspark-1.3 -Dspark.version<span class="o">=</span>1.3.1 -Dhadoop.version<span class="o">=</span>2.7.0 -Phadoop-2.6 -Pyarn -DskipTests +</code></pre></div> +<p>Building Zeppelin for first time downloads various dependencies and hence takes few minutes to complete. </p> + +<h2>Zeppelin Configuration</h2> + +<p>Zeppelin configurations needs to be modified to connect to YARN cluster. Create a copy of zeppelin environment XML</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">cp /home/zeppelin/incubator-zeppelin/conf/zeppelin-env.sh.template /home/zeppelin/incubator-zeppelin/conf/zeppelin-env.sh +</code></pre></div> +<p>Set the following properties</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash"><span class="nb">export </span><span class="nv">JAVA_HOME</span><span class="o">=</span>/home/zeppelin/prerequisites/jdk1.7.0_79 +<span class="nb">export </span><span class="nv">HADOOP_CONF_DIR</span><span class="o">=</span>/etc/hadoop/conf +<span class="nb">export </span><span class="nv">ZEPPELIN_JAVA_OPTS</span><span class="o">=</span><span class="s2">"-Dhdp.version=2.3.1.0-2574"</span> +</code></pre></div> +<p>As /etc/hadoop/conf contains various configurations of YARN cluster, Zeppelin can now submit Spark/Hive jobs on YARN cluster form its web interface. The value of hdp.version is set to 2.3.1.0-2574. This can be obtained by running the following command</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">hdp-select status hadoop-client <span class="p">|</span> sed <span class="s1">'s/hadoop-client - \(.*\)/\1/'</span> +<span class="c"># It returned 2.3.1.0-2574</span> +</code></pre></div> +<h2>Start/Stop</h2> + +<h3>Start Zeppelin</h3> +<div class="highlight"><pre><code class="text language-text" data-lang="text">cd /home/zeppelin/incubator-zeppelin +bin/zeppelin-daemon.sh start +</code></pre></div> +<p>After successful start, visit http://[zeppelin-server-host-name]:8080 with your web browser.</p> + +<h3>Stop Zeppelin</h3> +<div class="highlight"><pre><code class="text language-text" data-lang="text">bin/zeppelin-daemon.sh stop +</code></pre></div> +<h2>Interpreter</h2> + +<p>Zeppelin provides to various distributed processing frameworks to process data that ranges from Spark, Hive, Tajo, Ignite and Lens to name a few. This document describes to configure Hive & Spark interpreters.</p> + +<h3>Hive</h3> + +<p>Zeppelin supports Hive interpreter and hence copy hive-site.xml that should be present at /etc/hive/conf to the configuration folder of Zeppelin. Once Zeppelin is built it will have conf folder under /home/zeppelin/incubator-zeppelin.</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash">cp /etc/hive/conf/hive-site.xml /home/zeppelin/incubator-zeppelin/conf +</code></pre></div> +<p>Once Zeppelin server has started successfully, visit http://[zeppelin-server-host-name]:8080 with your web browser. Click on Interpreter tab next to Notebook dropdown. Look for Hive configurations and set them appropriately. By default hive.hiveserver2.url will be pointing to localhost and hive.hiveserver2.password/hive.hiveserver2.user are set to hive/hive. Set them as per Hive installation on YARN cluster. +Click on Save button. Once these configurations are updated, Zeppelin will prompt you to restart the interpreter. Accept the prompt and the interpreter will reload the configurations.</p> + +<h3>Spark</h3> + +<p>Zeppelin was built with Spark 1.3.1 and it was assumed that 1.3.1 version of Spark is installed at /home/zeppelin/prerequisites/spark. Look for Spark configrations and click edit button to add the following properties</p> + +<table class="table-configuration"> + <tr> + <th>Property Name</th> + <th>Property Value</th> + <th>Remarks</th> + </tr> + <tr> + <td>master</td> + <td>yarn-client</td> + <td>In yarn-client mode, the driver runs in the client process, and the application master is only used for requesting resources from YARN.</td> + </tr> + <tr> + <td>spark.home</td> + <td>/home/zeppelin/prerequisites/spark</td> + <td></td> + </tr> + <tr> + <td>spark.driver.extraJavaOptions</td> + <td>-Dhdp.version=2.3.1.0-2574</td> + <td></td> + </tr> + <tr> + <td>spark.yarn.am.extraJavaOptions</td> + <td>-Dhdp.version=2.3.1.0-2574</td> + <td></td> + </tr> + <tr> + <td>spark.yarn.jar</td> + <td>/home/zeppelin/incubator-zeppelin/interpreter/spark/zeppelin-spark-0.6.0-incubating-SNAPSHOT.jar</td> + <td></td> + </tr> +</table> + +<p>Click on Save button. Once these configurations are updated, Zeppelin will prompt you to restart the interpreter. Accept the prompt and the interpreter will reload the configurations.</p> + +<p>Spark & Hive notebooks can be written with Zeppelin now. The resulting Spark & Hive jobs will run on configured YARN cluster.</p> + +<h2>Debug</h2> + +<p>Zeppelin does not emit any kind of error messages on web interface when notebook/paragrah is run. If a paragraph fails it only displays ERROR. The reason for failure needs to be looked into log files which is present in logs directory under zeppelin installation base directory. Zeppelin creates a log file for each kind of interpreter.</p> +<div class="highlight"><pre><code class="bash language-bash" data-lang="bash"><span class="o">[</span>zeppelin@zeppelin-3529 logs<span class="o">]</span><span class="nv">$ </span><span class="nb">pwd</span> +/home/zeppelin/incubator-zeppelin/logs +<span class="o">[</span>zeppelin@zeppelin-3529 logs<span class="o">]</span><span class="nv">$ </span>ls -l +total 844 +-rw-rw-r-- 1 zeppelin zeppelin 14648 Aug 3 14:45 zeppelin-interpreter-hive-zeppelin-zeppelin-3529.log +-rw-rw-r-- 1 zeppelin zeppelin 625050 Aug 3 16:05 zeppelin-interpreter-spark-zeppelin-zeppelin-3529.log +-rw-rw-r-- 1 zeppelin zeppelin 200394 Aug 3 21:15 zeppelin-zeppelin-zeppelin-3529.log +-rw-rw-r-- 1 zeppelin zeppelin 16162 Aug 3 14:03 zeppelin-zeppelin-zeppelin-3529.out +<span class="o">[</span>zeppelin@zeppelin-3529 logs<span class="o">]</span><span class="nv">$ </span> +</code></pre></div> + </div> +</div> + + + <hr> + <footer> + <!-- <p>© 2016 The Apache Software Foundation</p>--> + </footer> + </div> + + + + + <script type="text/javascript"> + (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ + (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), + m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) + })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); + + ga('create', 'UA-45176241-5', 'zeppelin.incubator.apache.org'); + ga('require', 'linkid', 'linkid.js'); + ga('send', 'pageview'); + +</script> + + + + </body> +</html> +
