Installation

Installing the Vagrant box

The entire DU-Robocup system can be installed using Vagrant, a provider for virtual boxes. This should let you set up the entire build and work environment without having to deal with dependencies. The first step is to get the latest version of Vagrant from https://www.vagrantup.com/downloads.html. AVOID USING THE PACKAGE MANAGER TO DOWNLOAD VAGRANT as the version in many package managers is very outdated. Next, you have to install virtual box. You can get the latest version at https://www.virtualbox.org/wiki/Downloads. Next, create an empty folder somewhere on your system to hold the installation. It should have at least 5Gb of free space.

Downloading the requirements

Once you have the folder, open it in the terminal. Download the 'Vagrantfile' from here and place it in the directory you just created.

Provisioning the Vagrant box

Next, open terminal and switch to the directory that you just created (eg. cd my_vagrant_directory) and run the command mkdir NAO to create the shared linking folder. Then run the command vagrant up. NOTE: This script will take a long time, so be patient. This will configure the vagrant box.

Finalizing the provision

Finally, run the command vagrant ssh. This command will allow you to SSH into the new environment which you just created. If you type ls, you should be able to see a script called 'finalize_install.sh'. Run this script to finish installing using the command sh finalize_install.sh. You will be prompted for your git username and email, which will be used to clone the NAO-engine repository directly from github.

Installing and Building the Engine

To build the engine once the vagrant box is installed, all we have to do is run the command cd NAO && cd NAO-engine to switch to the root directory for the engine. Then run ./configure.sh and ./build.sh to build the entire engine (with GUI support). That's all it takes! No having to worry about dependencies or issues with compilation, as it is all boxed up!