You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@zeppelin.apache.org by mo...@apache.org on 2016/05/18 03:38:29 UTC

incubator-zeppelin git commit: [ZEPPELIN-281] Windows build

Repository: incubator-zeppelin
Updated Branches:
  refs/heads/master 332d74f34 -> 9a4d7ed92


[ZEPPELIN-281] Windows build

### What is this PR for?
Give some hints in README for source building on Windows.

### What type of PR is it?
Documentation

### Todos
* [fork] - Fork from the main repo
* [checkout] - Checkout the code
* [build] - Follow the standard way of build
* [test] - Run zeppelin using zeppelin.cmd

### What is the Jira issue?
https://issues.apache.org/jira/browse/ZEPPELIN-281

### How should this be tested?
Follow the standard way of build using Git and Maven.

### Questions:
* Does the licenses files need update? No
* Is there breaking changes for older versions? No
* Does this needs documentation? No

Author: Federico Valeri <fv...@users.noreply.github.com>
Author: fvaleri <fe...@gmail.com>

This patch had conflicts when merged, resolved by
Committer: Lee moon soo <mo...@apache.org>

Closes #876 from fvaleri/windows7-build and squashes the following commits:

8698333 [Federico Valeri] Update README.md
67064cc [Federico Valeri] Update README.md
72d31f6 [Federico Valeri] Fixed a typo.
38f19c7 [Federico Valeri] Formatting
5b4254d [fvaleri] Added some useful infos for Windows builds.


Project: http://git-wip-us.apache.org/repos/asf/incubator-zeppelin/repo
Commit: http://git-wip-us.apache.org/repos/asf/incubator-zeppelin/commit/9a4d7ed9
Tree: http://git-wip-us.apache.org/repos/asf/incubator-zeppelin/tree/9a4d7ed9
Diff: http://git-wip-us.apache.org/repos/asf/incubator-zeppelin/diff/9a4d7ed9

Branch: refs/heads/master
Commit: 9a4d7ed928480e727c350c55f8f9d70474b54bbe
Parents: 332d74f
Author: Federico Valeri <fv...@users.noreply.github.com>
Authored: Fri May 6 11:43:51 2016 +0200
Committer: Lee moon soo <mo...@apache.org>
Committed: Tue May 17 20:39:10 2016 -0700

----------------------------------------------------------------------
 README.md | 44 ++++++++++++++++++++++++++++++++++++++++----
 1 file changed, 40 insertions(+), 4 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/incubator-zeppelin/blob/9a4d7ed9/README.md
----------------------------------------------------------------------
diff --git a/README.md b/README.md
index 4265104..ce098c9 100644
--- a/README.md
+++ b/README.md
@@ -18,10 +18,11 @@ Core feature:
 To know more about Zeppelin, visit our web site [http://zeppelin.incubator.apache.org](http://zeppelin.incubator.apache.org)
 
 ## Requirements
+ * Git 
  * Java 1.7
- * Tested on Mac OSX, Ubuntu 14.X, CentOS 6.X
+ * Tested on Mac OSX, Ubuntu 14.X, CentOS 6.X, Windows 7 Pro SP1
  * Maven (if you want to build from the source code)
- * Node.js Package Manager (npm)
+ * Node.js Package Manager (npm, downloaded by Maven during build phase)
 
 ## Getting Started
 
@@ -29,14 +30,49 @@ To know more about Zeppelin, visit our web site [http://zeppelin.incubator.apach
 If you don't have requirements prepared, install it.
 (The installation method may vary according to your environment, example is for Ubuntu.)
 
-```sh
+```
 sudo apt-get update
 sudo apt-get install git
 sudo apt-get install openjdk-7-jdk
 sudo apt-get install npm
 sudo apt-get install libfontconfig
+```
 
-# install maven
+#### Proxy settings (optional)
+If you are behind a corporate Proxy with NTLM authentication you can use [Cntlm Authentication Proxy](http://cntlm.sourceforge.net/) .
+
+Before build start, run these commands from shell. 
+```
+export http_proxy=http://localhost:3128
+export https_proxy=http://localhost:3128
+export HTTP_PROXY=http://localhost:3128
+export HTTPS_PROXY=http://localhost:3128
+npm config set proxy http://localhost:3128
+npm config set https-proxy http://localhost:3128
+npm config set registry "http://registry.npmjs.org/"
+npm config set strict-ssl false
+npm cache clean
+git config --global http.proxy http://localhost:3128
+git config --global https.proxy http://localhost:3128
+git config --global url."http://".insteadOf git://
+```
+
+After build is complete, run these commands to cleanup.
+```
+npm config rm proxy
+npm config rm https-proxy
+git config --global --unset http.proxy
+git config --global --unset https.proxy
+git config --global --unset url."http://".insteadOf
+```
+
+_Notes:_ 
+ - If you are on Windows replace `export` with `set` to set env variables
+ - Replace `localhost:3128` with standard pattern `http://user:pwd@host:port`
+ - Git configuration is needed because Bower use it for fetching from GitHub
+ 
+#### Install maven
+```
 wget http://www.eu.apache.org/dist/maven/maven-3/3.3.3/binaries/apache-maven-3.3.3-bin.tar.gz
 sudo tar -zxf apache-maven-3.3.3-bin.tar.gz -C /usr/local/
 sudo ln -s /usr/local/apache-maven-3.3.3/bin/mvn /usr/local/bin/mvn