OME Ansible Training 2017: Setup

This training session is in the form of an instructor-led workshop.

To follow along, you’ll need the some prerequisites:

Hardware Requirements:

• 1.5GB ram free
• 2GB local disk free

Software Requirements (links/instructions below):

• Ansible (2.0+)
• Virtualbox (5+)
• Vagrant (1.9+)

Git clones of:

• github.com/ome/ansible-examples-omero
• github.com/openmicroscopy/managment_tools

Network Requirements:

• Some steps will require the machine you’re running Ansible from to be on the Life Sciences network, so locally connected or VPN.

Installing the requirements

Shell commands and output are shown as follows:

$ example command

example output

Ansible

The installation instructions for all platforms are at docs.ansible.com.

OS X users: The Ansible project are currently recommending users install it via pip. I’ve read that using --user can make installation easier on 10.11+, so perhaps try pip install --user ansible.

You can test your install by running:

$ ansible localhost -m ping

localhost | SUCCESS => {
    "changed": false,
        "ping": "pong"
        }

Ansible Source and related files

Make git clones of the following repositories, in your favourite clones directory, e.g. ~/clones/.

• github.com/ome/ansible-examples-omero
• github.com/openmicroscopy/managment_tools

VirtualBox

A lightweight method of running virtual machines on your desktop/laptop. Follow the graphical installer you can download from virtualbox.org. Once that completes, VirtualBox should be ready to use.

Vagrant

This is a tool which can automate the configuration of local virtual machines, including VirtualBox. With this we can create a VM from a text definition in one command.

1 Follow the graphical installer you can download from vagrantup.com.

2 Once vagrant is installed, download the centos/7 box as follows:

Run (in any directory):

$ vagrant box add centos/7 # When prompted, choose 3 `virtualbox` 

==> box: Loading metadata for box 'centos/7'
    box: URL: https://vagrantcloud.com/centos/7
    This box can work with multiple providers! The providers that it
    can work with are listed below. Please review the list and choose
    the provider you will be working with.

    1) hyperv
    2) libvirt
    3) virtualbox
    4) vmware_desktop

    Enter your choice: 3

==> box: Adding box 'centos/7' (v1710.01) for provider: virtualbox
    box: Downloading: https://vagrantcloud.com/centos/boxes/7/versions/1710.01/providers/virtualbox.box
        box: Progress: 24% (Rate: 9.9M/s, Estimated time remaining: 0:00:27)
==> box: Successfully added box 'centos/7' (v1710.01) for 'virtualbox'!

Confirm the box was installed with:

$ vagrant box list | grep centos/7

centos/7         (virtualbox, 1710.01)

Problems getting set up?

Ask in slack, and someone will help.