Set up Tango

Introduction

This document outlines the steps needed to set up the Tango service.

Setting up the Tango server

1. Obtain the source code.

   $ git clone https://github.com/daviddob/Tango.git; cd Tango

2. Create a config.py file from the given template.

   $ cp config.template.py config.py

3. Create a courselabs directory and assign that path to Config.COURSELABS in config.py.

4. Populate Config.KEYS in config.py with some keys that the client will need to know to send jobs to Tango.

5. Set up a VMMS for Tango to use. To do this, follow one of the VMMS set up guides on the wiki sidebar:

   • Set up Local Docker VMMS
   • Set up Dist Docker VMMS
   • Set up Amazon EC2 VMMS

6. Depending on the VMMS that is selected, you may also need to manually bootstrap the VMs that are used to ensure that Tango has the appropriate permissions to run jobs on the VM. This will be specified if necessary in the corresponding VMMS set up guide.

7. Set up your environment. From the Tango directory:

   $ sudo apt-get install python-pip
   $ pip install virtualenv
   $ virtualenv .
   $ source bin/activate
   $ pip install -r requirements.txt
   $ mkdir volumes

If you are on OS X, append the --user flag when installing the dependencies to avoid permission errors

Running Tango

See the start up guide.

Testing Your Setup

See the testing guide.