Quick deploy from an Ubuntu Live CD

This page details how to deploy the software from a Live Ubuntu 15.10 image.

Assumptions:

• You have a Ubuntu Live image (on a flash disk at least 16GB...I mean, it should work with something smaller, but I provide no guarantees)
• The image is for Ubuntu 15.10
• You have an Internet connection
• You have a means to connect to the topside switch (Ethernet adapter and cable)
• There is an existing release you want to deploy—this page does not detail the process for editing the control software

Connecting to the ROV network

Notes:

• Connect to the ROV network before connecting to the Internet via Wi-Fi
• Your IP address will need to be 192.168.88.3

Things start off, unfortunately, a bit hand-wavy. Look at Initial topside configuration, and follow the instructions there for setting a static IP address via the first four (4) non-optional bullet points under "Process". Remember to use 192.168.88.3 in place of 192.168.88.2 (as per the note above).

Installing updates

You will need to enable the universe before updating.

sudo apt update && sudo apt upgrade

Installing Ansible

Run the following in a terminal window:

sudo apt-add-repository -y ppa:ansible/ansible
sudo apt-get update
sudo apt-get -y install ansible

Download the control software from GitHub

1. Under the releases tab, select the version you want to download (select source code or zip)
2. Unzip the archive
3. Change into the project directory

Setup your development environment

1. Run gedit playbooks/hosts to open up the hosts file in a text editor

2. Edit the hosts file to have the following contents:

    [captain]
    192.168.88.3 ansible_connection=local ansible_user=ubuntu
   
    [topside]
    192.168.88.2 ansible_user=eedge ansible_ssh_pass=eedge ansible_sudo_pass=eedge
   
    [rasprime]
    192.168.88.4 ansible_user=pi ansible_ssh_pass=raspberry
   
    [picamera]
    192.168.88.5 ansible_user=pi ansible_ssh_pass=raspberry
   

3. Run ansible-playbook playbooks/all.yml

4. Wait a bit

5. Additionally run (and wait for) sudo apt-get install openjfx

Build the control software

1. Run gradle build

Deploy the control software

1. Run ansible-playbook playbooks/deploy.yml