Lucida Installation Instructions

November 29, 2016

Overview

In this tutorial, you will deploy Lucida on your Mac. Once it is deployed, follow tutorial.pdf for demo. The entire process may take several hours.

As bonus, you will learn:

1. How to set up a Ubuntu virtual machine

2. How to execute some basic Linux commands

3. How to use Docker and Kubernetes

Prerequisite: Mac OS X

Steps

Important: Please copy and paste the command line instructions rather than manually type.

1

Download the Ubuntu 14.04 64-bit iso image from http://releases.ubuntu.com/14.04/. Docker does not work on a 32-bit OS, so please choose a 64-bit version. Simply download to your file system without extracting/unzipping. It may take a while

2

Install Parallel Desktop 11 for Mac from http://www.parallels.com/products/desktop/download/ and open it

3

Click + to create a new Ubuntu 14.04 virtual machine

4

Click the middle button "Install Windows or another OS from a DVD or image file". We are installing Ubuntu from the image file you downloaded in step 1

5

Locate the Ubuntu 14.04 64-bit iso image, then click Continue

6

Set password, click Continue, name it to Lucida, check the box Custom Settings before installation, then click Continue

7

Locate Hardware, click the lock button to make changes, and then set memory to near the maximum amount in the green range (for example, 8 GB in the below case). Usually, anywhere between 4 GB and 8 GB is fine

8

Close the window, click Continue, and wait until Ubuntu 14.04 is set up. It may take a while

9

Click the search button, locate Terminal, and open it

10

Run wget https://github.com/claritylab/lucida/archive/master.zip to download Lucida Github repo

11

Run unzip master.zip followed by ls to see a directory lucida-master/

12

Run wget -qO- https://get.docker.com/ | sh followed by sudo usermod -aG docker $(whoami) to install Docker. After that, log out and back in for this to take effect

13

Open the terminal again, and run sudo start docker

14

Run cd lucida-master/tools/deploy/ followed by sudo ./cluster_up_linux.sh to start a Kubernetes cluster

15

Run sudo chown -R $(whoami) /home/$(whoami)/.kube/config to give yourself permission to a Kubernetes-related directory

16

Run sudo ./start_services.sh followed by kubectl get pod to start all the services and monitor the status. Kubernetes starts downloading the images, so please wait until the status of every pod becomes running. It may take a while

17

Inside Ubuntu, visit localhost:30000 in your browser. If you want to access Lucida from OS X, please set up port forwarding

Congratulations!

It's done. Lucida is runnin in your virtual machine. Follow tutorial.pdf for demo.

How to uninstall?

• If you want to remove Lucida along with Ubuntu, simply go back to the control panel of Parallel Desktop, right click the virtual machine, and select "Remove"

• If you want to remove Lucida but keep using Ubuntu, run the following commands twice to stop and remove all the Docker containers currently running in the virtual machine:

dockerlist=$(docker ps -a -q)
if [ "${dockerlist}" != "" ]; then
  for d in ${dockerlist}; do
    echo "***** ${d}"
    docker stop ${d} 2>&1 > /dev/null
    docker rm ${d} 2>&1 > /dev/null
    done
  fi