Home

Welcome to the Berkeley Smart Grid Store installer.

This guide is for BTrDB 3.x, the stable series of BTrDB, but the installation process has been backported from the in-development BTrDB 4.x. For this reason, the process is streamlined for installation on a cluster, even though BTrDB 3.x only utilizes the cluster for ceph, the rest of the software exists on a single machine.

This is also tailored for the use of BTrDB in the Berkeley Smart Grid Stack, but is very convenient for simply setting up BTrDB without the rest of the stack, as it will take care of the (somewhat arduous) process involved in formatting and associating containerized Ceph OSDs with new Ceph MONs. The guide will call out where you can skip or disable uPMU specific services.

Overview

The installation procedure is broken into a few sections, that you can pick and choose based on what kind of platform you are installing on. The only supported configuration is installation on to three or more dedicated instances (whether that be EC2 instances, VMs or physical servers) running Ubuntu 16.04.1. As a result, the installation script will assume it is free to install whatever is required, reboot and otherwise reconfigure the servers. If you are using this set of scripts on existing servers, please read the through the script beforehand and ensure they will not disrupt your services.

Step 1: Set up new EC2 instances

This stage will walk you through setting up some new EC2 instances to run BTrDB and the Berkeley Smart Grid Store.

Step 2: Setting up the quickstart environment

Next we will set up the quickstart environment so that the commands know how to find and communicate with your servers.

Step 3: Preparing your servers

This stage will ensure that your servers are up-to-date, have Docker installed, have a healthy Etcd cluster, and running Fleet.

Step 4: Probing and generating an installation plan

Here, the quickstart kit will scan your servers for you, and suggest an installation plan. You then need to modify that plan and approve it. Here is where you can choose which services run on which servers.

Step 5: Executing the installation plan

Once your installation plan is approved, simply execute it, grab a coffee and come back to a fully set up BTrDB / SGS