7764465b12
### What is this PR for? Due to recent work on versioned notes under ZEPPELIN-1044, we can use by default Git storage which extends local storage. so the behaviour will be same as before with additional ability to use versioning out of box without configuring it. ### What type of PR is it? Improvement | Refactoring ### Todos * [x] - change VFS to Git ### What is the Jira issue? [ZEPPELIN-1825](https://issues.apache.org/jira/browse/ZEPPELIN-1825) ### How should this be tested? start zeppelin and by default be able to use version control (if git client installed) ### Screenshots (if appropriate) ### Questions: * Does the licenses files need update? no * Is there breaking changes for older versions? no * Does this needs documentation? no Author: Khalid Huseynov <khalidhnv@gmail.com> This patch had conflicts when merged, resolved by Committer: Lee moon soo <moon@apache.org> Closes #1844 from khalidhuseynov/default-git-repo and squashes the following commits:ac23085[Khalid Huseynov] update indtall.md table7cb133c[Khalid Huseynov] add note in upgrade.mdcc3b541[Khalid Huseynov] fix in zeppelin-site.xmlcb9e9fb[Khalid Huseynov] modify default storage to git repo
4.9 KiB
| layout | title | description | group |
|---|---|---|---|
| page | Quick Start | This page will help you get started and will guide you through installing Apache Zeppelin and running it in the command line. | install |
{% include JB/setup %}
Quick Start
Welcome to Apache Zeppelin! On this page are instructions to help you get started.
Installation
Apache Zeppelin officially supports and is tested on the following environments:
| Name | Value |
|---|---|
| Oracle JDK | 1.7 (set JAVA_HOME) |
| OS | Mac OSX Ubuntu 14.X CentOS 6.X Windows 7 Pro SP1 |
Downloading Binary Package
Two binary packages are available on the Apache Zeppelin Download Page. Only difference between these two binaries is interpreters are included in the package file.
-
Package with
allinterpreters.Just unpack it in a directory of your choice and you're ready to go.
-
Package with
net-installinterpreters.Unpack and follow install additional interpreters to install interpreters. If you're unsure, just run
./bin/install-interpreter.sh --alland install all interpreters.
Starting Apache Zeppelin
Starting Apache Zeppelin from the Command Line
On all unix like platforms:
bin/zeppelin-daemon.sh start
If you are on Windows:
bin\zeppelin.cmd
After Zeppelin has started successfully, go to http://localhost:8080 with your web browser.
Stopping Zeppelin
bin/zeppelin-daemon.sh stop
Start Apache Zeppelin with a service manager
Note : The below description was written based on Ubuntu Linux.
Apache Zeppelin can be auto-started as a service with an init script, using a service manager like upstart.
This is an example upstart script saved as /etc/init/zeppelin.conf
This allows the service to be managed with commands such as
sudo service zeppelin start
sudo service zeppelin stop
sudo service zeppelin restart
Other service managers could use a similar approach with the upstart argument passed to the zeppelin-daemon.sh script.
bin/zeppelin-daemon.sh upstart
zeppelin.conf
description "zeppelin"
start on (local-filesystems and net-device-up IFACE!=lo)
stop on shutdown
# Respawn the process on unexpected termination
respawn
# 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 example
chdir /usr/share/zeppelin
exec bin/zeppelin-daemon.sh upstart
Next Steps
Congratulations, you have successfully installed Apache Zeppelin! Here are few steps you might find useful:
New to Apache Zeppelin...
- For an in-depth overview, head to Explore Apache Zeppelin UI.
- And then, try run tutorial notebook in your Zeppelin.
- And see how to change configurations like port number, etc.
Zeppelin with Apache Spark ...
- To know more about deep integration with Apache Spark, check Spark Interpreter.
Zeppelin with JDBC data sources ...
- Check JDBC Interpreter to know more about configure and uses multiple JDBC data sources.
Zeppelin with Python ...
- Check Python interpreter to know more about Matplotlib, Pandas, Conda/Docker environment integration.
Multi-user environment ...
- Turn on authentication.
- Manage your notebook permission.
- For more informations, go to More -> Security section.
Other useful informations ...
- Learn how Display System works.
- Use Service Manager to start Zeppelin.
- If you're using previous version please see Upgrade Zeppelin version.
Building Apache Zeppelin from Source
If you want to build from source instead of using binary package, follow the instructions here.