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 <[email protected]> Author: fvaleri <[email protected]> This patch had conflicts when merged, resolved by Committer: Lee moon soo <[email protected]> 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 <[email protected]> Authored: Fri May 6 11:43:51 2016 +0200 Committer: Lee moon soo <[email protected]> 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
