Docs

Install YugaByte DB

Prerequisites

a) You must have the Docker runtime installed on your localhost. Follow the links below to download and install Docker if you have not done so already.

Docker for Mac

Docker for CentOS

Docker for Ubuntu

Docker for Debian

Docker for Windows

b) You must have python installed on your localhost.

Download

Download the yb-docker-ctl utility. This utility has a set of pre-built commands to create and thereafter administer a containerized local cluster.

$ mkdir ~/yugabyte && cd ~/yugabyte
$ wget https://downloads.yugabyte.com/yb-docker-ctl && chmod +x yb-docker-ctl

Install

Confirm that Docker and python are installed correctly.

$ docker ps
$ python --version

Pull the YugaByte DB container.

$ docker pull yugabytedb/yugabyte

Prerequisites

You must have Minikube installed on your localhost. Follow these instructions to install Minikube along with its pre-requisites.

We will be using the StatefulSets workload API of Kubernetes, so you should have a version that supports this (preferably 1.8+). Run the version commands as shown below to verify the version.

$ minikube version
minikube version: v0.25.0

Also confirm that your kubectl is configured correctly.

$ kubectl version
Client Version: version.Info{Major:"1", Minor:"9", GitVersion:"v1.9.1", GitCommit:"3a1c9449a956b6026f075fa3134ff92f7d55f812", GitTreeState:"clean", BuildDate:"2018-01-04T11:52:23Z", GoVersion:"go1.9.2", Compiler:"gc", Platform:"darwin/amd64"}
Server Version: version.Info{Major:"1", Minor:"8", GitVersion:"v1.8.0", GitCommit:"0b9efaeb34a2fc51ff8e4d34ad9bc6375459c4a4", GitTreeState:"dirty", BuildDate:"2017-10-17T15:09:55Z", GoVersion:"go1.8.3", Compiler:"gc", Platform:"linux/amd64"}

Start Kubernetes

Start Kubernetes via Minikube with the following command.

$ minikube start

Review Kubernetes dashboard with the following command.

$ minikube dashboard

Download

Download yugabyte-k8s-statefulset.yaml. This will create a local YugaByte DB cluster on Kubernetes with a replication factor of 3.

$ mkdir ~/yugabyte && cd ~/yugabyte
$ wget https://downloads.yugabyte.com/kubernetes/yugabyte-statefulset.yaml

Prerequisites

macOS 10.12 (Sierra) or higher

Download

Download the YugaByte CE package as shown below.

$ wget https://downloads.yugabyte.com/yugabyte-ce-0.9.5.0-darwin.tar.gz
$ tar xvfz yugabyte-ce-0.9.5.0-darwin.tar.gz && cd yugabyte-0.9.5.0/

Configure

Setup loopback IP addresses on your localhost so that every node in the 3 node local cluster gets a unique IP address of its own.

sudo ifconfig lo0 alias 127.0.0.2
sudo ifconfig lo0 alias 127.0.0.3

Add some more loopback IP addresses to cover the add node scenarios of the Explore Core Features section.

sudo ifconfig lo0 alias 127.0.0.4
sudo ifconfig lo0 alias 127.0.0.5
sudo ifconfig lo0 alias 127.0.0.6
sudo ifconfig lo0 alias 127.0.0.7

Prerequisites

One of the following operating systems

CentOS 7

Ubuntu 16.04+

Download

Download the YugaByte CE package as shown below.

$ wget https://downloads.yugabyte.com/yugabyte-ce-0.9.5.0-linux.tar.gz
$ tar xvfz yugabyte-ce-0.9.5.0-linux.tar.gz && cd yugabyte-0.9.5.0/

Configure

$ ./bin/post_install.sh