Introduction

This repo helps in making it ease to setup greenplum database on your local environment. You can provision single node deployment or multi node deployment cluster and test the functionality of the product

This repository is split into two parts

• Datalab cli

  The datalab cli helps to create & manage vagrant VM's provisioning.

• Gpdb cli

  The gpdb cli helps to download, install, remove and manage the software of GPDB / GPCC.)

If you are interested in creating demo database / table and loading fake data to those table for testing purpose, check out the project mock-data

Table of Contents

• Table of Contents
• Prerequisite
  • VirtualBox
  • Vagrant
• Installation
• Tools
  • Gpdb cli
  • Datalab cli
  • UnitTest
  • Vagrant
• Demo (installation)
• Developers / Contributor's

Prerequisite

The "go-gpdb" software needs the below two tools pre-installed on your machine for it to work. Please follow the below instruction on how to setup the prerequisite

VirtualBox

• If not already installed, download and install VirtualBox or you can use brew to install virtual box using the command

  brew update
  brew cask install virtualbox
  

• Once you virtualbox installation is complete ensure you have two interfaces (namely vboxnet0/1 is seen) on your MAC,

  IRFALI123:Vagrant fali$ ifconfig
  vboxnet0: flags=8842<BROADCAST,RUNNING,SIMPLEX,MULTICAST> mtu 1500
      ether 0a:00:27:00:00:00
  vboxnet1: flags=8943<UP,BROADCAST,RUNNING,PROMISC,SIMPLEX,MULTICAST> mtu 1500
      ether 0a:00:27:00:00:01
      inet 192.168.11.1 netmask 0xffffff00 broadcast 192.168.11.255
  

  if its not shown then refer to the link for Virtualbox version lower than 5 and if your virtualbox version is 5 and above follow this link on how to set those two interfaces up

Vagrant

• On your MAC install vagrant using the below command ( if vagrant executable is not already installed )

  brew update
  brew cask install vagrant
  

  If you have already installed vagrant ensure you are running the latest version of vagrant, to update your vagrant run

  brew update
  brew cask reinstall vagrant
  

• Once the vagrant is installed, install the vagrant plugin using the below command

  vagrant plugin install vagrant-hosts
  

Installation

If you have your own VM and would like to use that, then follow this instruction on how to setup and use the go-gpdb. If you like to also setup a VM and also install gpdb then follow the set of instruction below

• Ensure you have completed all the Prerequisite as mentioned on the Prerequisite section above.
• Download the latest version of the datalab CLI and follow the steps mentioned on the installation and setup section to setup the datalab CLI
• Provision the VM's using the steps mentioned here
• Once successfully provisioned, you can now start using the gpdb cli to download, install & manage gpdb software, refer the example for more information. NOTE: gpdb cli is automaticalled installed on the provision VM's

Tools

Gpdb cli

• Please check the gpdb cli README for details on how to install & use the gpdb cli.

Datalab cli

• Please check the datalab cli README for details on how to install & use the datalab cli.

UnitTest

• Please check the README on how to run the unit test case.

Vagrant

• If you wish to install vagrant manually using the Vagrant file & don't want to use the datalab cli, please follow the instruction mentioned here for all the options.

Demo (installation)

Developers / Contributor's

Please read the section on how to setup the environment to test and hack this tool