Dependencies

To automatically deploy DISCOS, you need to install some dependencies: Git, Ansible, Python 2.7, Vagrant and VirtualBox. It usually takes about 15 minutes.

Install Git

Before installing Git, verify if it is already installed:

$ git --version
git version 2.17.1

You do not need a particular version of Git, but if the command git --version fails, than you have to install Git by following the instructions at the official Git website.

Install a Python 2.7 environment

The whole DISCOS deployment procedure relies on Python 2.7. Verify if Python 2.7 is already installed on your system:

$ python --version
Python 2.7.15rc1

If your system comes bundled with a different Python version, you may want to consider installing a Python 2.7 environment such as Anaconda, Miniconda or Pyenv and its Virtualenv plugin.

Install VirtualBox and Vagrant

You need to install VirtualBox and Vagrant only if you want to deploy DISCOS on virtual machines, as in the case of a development environment. As a first step, check if VirtualBox is already installed:

$ which virtualbox
/usr/bin/virtualbox

In case it is not, download the binary file from the official website and install it.

Note

The suggested VirtualBox version to install is the 5.1. As of today, the latest release of VirtualBox, version 5.2, seems to introduce some lag in SSH sessions to the deployed virtual machines. Version 5.1 also matches the VirtualBox guest additions already installed in the virtual machines.

Now verify if Vagrant is installed:

$ vagrant --version
Vagrant 2.2.1

If it is not, download the binary file from the vagrant official website and install it.

At this point you are ready to deploy DISCOS. The Quick start section is a good starting point, because it covers a typical scenario.