Installation

Setting Up and Installing the Vagrant box:

---

Please make sure to follow each step correctly.

Prerequisites:

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 (everything should just work perfectly). Note: These instructions are for 64bit Linux Operating Systems, though they can easily be adapted to other operating systems with a few changes

1. Download the latest version of Vagrant from https://www.vagrantup.com/downloads.html. AVOID USING YOUR PACKAGE MANAGER TO DOWNLOAD VAGRANT. While rolling release Linux distributions like Arch and Gentoo likely have the up to date version, distro's like Ubuntu in our experience won't and this will cause issues.

2. Download Virtual Box. You can use your package manager for this, we suggest getting the guest-additions package as well. The latest versions can be found here. If you have issues with getting virtualbox to work, the Arch Wiki has a good guide.

3. Create an empty folder on your computer, on a disk with at least 5Gb of free space. This will contain the Vagrant environment.

4. Open a terminal in this new folder and type vagrant init

Downloading Our Vagrant File:

Change directories to the new folder which will contain your vagrant environment and download the file here: https://raw.githubusercontent.com/DU-RoboCup/vagrant-install/master/Vagrantfile and place it in this directory. It is necessary to replace the existing 'Vagrantfile' with our new version if one already exists.

Provisioning the Vagrant box:

1. With the terminal you opened earlier, which should already located in the vagrant directory you created, create a new directory called NAO (mkdir NAO). This will create a shared folder between your computer and the virtual Vagrant environment where you can access the files on the Vagrant environment.
2. Enter the command vagrant up. NOTE: This script will take a long time, so be patient. This will configure the vagrant box.

Finalizing the Provision:

1. Download the Linux 64-bit SDK as well as the Linux 64-bit cross compiler SDK for the NAO from Aldebaran's website. Note: You do have to create a free account to get the SDKs. Move the downloaded SDKs, in their archived formats, to the NAO/NAOSDKs directory (where you setup the Vagrant directory).
2. Using the terminal that is still in the directory as the Vagrant folder you created, enter the command: vagrant ssh
3. Finally, enter cd NAO then enter the command sh setup.sh. Follow the instructions given by the script, and the development environment should be properly setup afterward. Entering your github username and password will setup the Vagrant instance with your account at this point rather then later.

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/NAO-engine to switch to the root directory for the engine. Then run ./build.sh local cross 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!

Exiting the Vagrant Environment:

When you're done working on things in the vagrant environment, typing exit will exit the ssh session, and then typing vagrant halt will shutdown the vagrant instance and save your current changes.