Repository: bigtop Updated Branches: refs/heads/master 221ac5d94 -> 59d192b9f
BIGTOP-1296 : Fix permission and Update README for vagrant-puppet recipe Signed-off-by: jayunit100 <[email protected]> Project: http://git-wip-us.apache.org/repos/asf/bigtop/repo Commit: http://git-wip-us.apache.org/repos/asf/bigtop/commit/59d192b9 Tree: http://git-wip-us.apache.org/repos/asf/bigtop/tree/59d192b9 Diff: http://git-wip-us.apache.org/repos/asf/bigtop/diff/59d192b9 Branch: refs/heads/master Commit: 59d192b9f9324df000cc54ab636e9a75a466b80c Parents: 221ac5d Author: jayunit100 <[email protected]> Authored: Mon May 5 18:31:37 2014 -0500 Committer: jayunit100 <[email protected]> Committed: Tue May 6 09:29:54 2014 -0500 ---------------------------------------------------------------------- bigtop-deploy/vm/vagrant-puppet/README.md | 61 ++++++++++++++++--------- bigtop-deploy/vm/vagrant-puppet/startup.sh | 0 2 files changed, 40 insertions(+), 21 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/bigtop/blob/59d192b9/bigtop-deploy/vm/vagrant-puppet/README.md ---------------------------------------------------------------------- diff --git a/bigtop-deploy/vm/vagrant-puppet/README.md b/bigtop-deploy/vm/vagrant-puppet/README.md index ce7fc8e..bebf7ed 100644 --- a/bigtop-deploy/vm/vagrant-puppet/README.md +++ b/bigtop-deploy/vm/vagrant-puppet/README.md @@ -15,38 +15,57 @@ ------------------------------------------------------------------------------------------------------------------------------------------------------ -#Deploy Apache Hadoop VM(s) on top of vagrant boxes using puppet +#BigTop VM provisioner -##Preparation -* You need to install [vagrant-hostmanager plugin](https://github.com/smdahlen/vagrant-hostmanager) to better manage `/etc/hosts` -<pre> -$ vagrant plugin install vagrant-hostmanager -</pre> +## Overview -##Usage +The startup.sh script runs one of 3 vagrant templates, and creates a bigtop virtual hadoop cluster for you, by +pulling from existing publishing bigtop repositories. This cluster can be used: -* To provision a 3 node Apache Hadoop cluster on top of vagrant boxes -<pre> -$ ./startup.sh --cluster -</pre> +- to test bigtop smoke tests +- to test bigtop puppet recipes -* See options with -h specified -<pre> +Eventually, we may also add ability to build AND provision bigtop in a vagrant recipe, which would essentially +give full validation of the BigTop stack. + +## USAGE + +1) Install [vagrant-hostmanager plugin](https://github.com/smdahlen/vagrant-hostmanager) to better manage `/etc/hosts` + +``` +vagrant plugin install vagrant-hostmanager +``` + +2) To provision a 3 node Apache Hadoop cluster on top of vagrant boxes + +``` +./startup.sh --cluster +``` + +3) See options with -h specified + +``` $ ./startup.sh -h -usage: startup.sh [options] + + usage: startup.sh [options] + -s, --standalone deploy a standalone hadoop vm + -c, --cluster deploy a 3 node hadoop cluster + -h, --help -</pre> +``` + +##Example: -* Run hbase-test.sh to evaluate the deployment. +4) Run hbase-test.sh to evaluate the deployment. ##Configure Apache Hadoop ecosystem components -* Choose the ecosystem you want to be deployed by modify components in provision.sh: +* Choose the ecosystem you want to be deployed by modify components in provision.sh. -<pre> +``` components,hadoop,hbase,... -</pre> +``` - By default, Apache Hadoop and Apache HBase will be installed. - See `bigtop-deploy/puppet/config/site.csv.example` for more details. +By default, Apache Hadoop and Apache HBase will be installed. +See `bigtop-deploy/puppet/config/site.csv.example` for more details. http://git-wip-us.apache.org/repos/asf/bigtop/blob/59d192b9/bigtop-deploy/vm/vagrant-puppet/startup.sh ---------------------------------------------------------------------- diff --git a/bigtop-deploy/vm/vagrant-puppet/startup.sh b/bigtop-deploy/vm/vagrant-puppet/startup.sh old mode 100644 new mode 100755
