Apply auto TOC to all of docs under docs/install/

This commit is contained in:
AhyoungRyu 2016-06-16 19:43:28 -07:00
parent f35db4730f
commit db76eb60ed
2 changed files with 24 additions and 14 deletions

View file

@ -19,12 +19,14 @@ limitations under the License.
-->
{% include JB/setup %}
## Manual upgrade procedure for Zeppelin
# Manual upgrade procedure for Zeppelin
<div id="toc"></div>
Basically, newer version of Zeppelin works with previous version notebook directory and configurations.
So, copying `notebook` and `conf` directory should be enough.
### Instructions
## Instructions
1. Stop Zeppelin
```
@ -33,7 +35,7 @@ So, copying `notebook` and `conf` directory should be enough.
1. Copy your `notebook` and `conf` directory into a backup directory
1. Download newer version of Zeppelin and Install. See [Install page](./install.html)
1. Download newer version of Zeppelin and Install. See [Install page](./install.html#installation).
1. Copy backup `notebook` and `conf` directory into newer version of Zeppelin `notebook` and `conf` directory
@ -41,4 +43,4 @@ So, copying `notebook` and `conf` directory should be enough.
```
bin/zeppelin-daemon.sh start
```
```

View file

@ -19,8 +19,11 @@ limitations under the License.
-->
{% include JB/setup %}
# Vagrant Virtual Machine for Apache Zeppelin
## Vagrant Virtual Machine for Apache Zeppelin
<div id="toc"></div>
## Overview
Apache Zeppelin distribution includes a scripts directory
@ -30,11 +33,11 @@ This script creates a virtual machine that launches a repeatable, known set of c
For PySpark users, this script includes several helpful [Python Libraries](#python-extras).
For SparkR users, this script includes several helpful [R Libraries](#r-extras).
####Installing the required components to launch a virtual machine.
### Prerequisites
This script requires three applications, [Ansible](http://docs.ansible.com/ansible/intro_installation.html#latest-releases-via-pip "Ansible"), [Vagrant](http://www.vagrantup.com "Vagrant") and [Virtual Box](https://www.virtualbox.org/ "Virtual Box"). All of these applications are freely available as Open Source projects and extremely easy to set up on most operating systems.
### Create a Zeppelin Ready VM in 4 Steps (5 on Windows)
## Create a Zeppelin Ready VM
If you are running Windows and don't yet have python installed, [install Python 2.7.x](https://www.python.org/downloads/release/python-2710/) first.
@ -60,9 +63,15 @@ curl -fsSL https://raw.githubusercontent.com/NFLabs/z-manager/master/zeppelin-in
```
### Building Zeppelin
## Building Zeppelin
You can now `git clone git://git.apache.org/zeppelin.git` into a directory on your host machine, or directly in your virtual machine.
You can now
```
git clone git://git.apache.org/zeppelin.git
```
into a directory on your host machine, or directly in your virtual machine.
Cloning Zeppelin into the `/scripts/vagrant/zeppelin-dev` directory from the host, will allow the directory to be shared between your host and the guest machine.
@ -74,14 +83,13 @@ By default, Vagrant will share your project directory (the directory with the Va
`cd /vagrant/zeppelin`
### What's in this VM?
## What's in this VM?
Running the following commands in the guest machine should display these expected versions:
`node --version` should report *v0.12.7*
`mvn --version` should report *Apache Maven 3.3.3* and *Java version: 1.7.0_85*
The virtual machine consists of:
- Ubuntu Server 14.04 LTS
@ -96,7 +104,7 @@ The virtual machine consists of:
- Python addons: pip, matplotlib, scipy, numpy, pandas
- [R](https://www.r-project.org/) and R Packages required to run the R Interpreter and the related R tutorial notebook, including: Knitr, devtools, repr, rCharts, ggplot2, googleVis, mplot, htmltools, base64enc, data.table
### How to build & run Zeppelin
## How to build & run Zeppelin
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. The following build steps will also include Python and R support via PySpark and SparkR:
@ -111,7 +119,7 @@ On your host machine browse to `http://localhost:8080/`
If you [turned off port forwarding](#tweaking-the-virtual-machine) in the `Vagrantfile` browse to `http://192.168.51.52:8080`
### Tweaking the Virtual Machine
## Tweaking the Virtual Machine
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.
@ -125,7 +133,7 @@ config.vm.network "private_network", ip: "192.168.51.52"
`vagrant halt` followed by `vagrant up` will restart the guest machine bound to the IP address of `192.168.51.52`.
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..
## Extras
### Python Extras
With Zeppelin running, **Numpy**, **SciPy**, **Pandas** and **Matplotlib** will be available. Create a pyspark notebook, and try the below code.