/go-gpdb

Pivotal Greenplum Database downloader and installer based in golang

Primary LanguageGoMIT LicenseMIT

Introduction Go Version MIT License

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.)

Table of Contents

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

  • 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)

asciicast

Developers / Contributor's

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