Linux Setup

If you need to install Ubuntu first, start with Installing Linux to see how you can dual boot Ubuntu or check out VirtualBox Setup to get Ubuntu running under your current OS. Make sure you have at least version 10.10 (Maverick Meerkat).

For Minimal Work

Install Git (and gitk, a useful GUI). You'll need to configure it, too.

$> sudo apt-get install git-core gitk

Follow steps 1-5 in Configuring Git. The script will take care of the rest.

CD into nbites/util/scripts and run, with [naoqi version] being the latest version of Naoqi, currently 1.10.52:

$> ./linux_setup.sh [naoqi version]

This script sets up a Linux machine with all necessary software and files. Make sure to keep an eye out for the script running or else it might time out on parts where user input is required! Also follow the instructions shown at the end of running the script.

Otherwise

a.k.a a more detailed walkthrough

1. Install Necessary Packages

• Install a compiler. The easiest way to do this is

$> sudo apt-get install build-essential

• Install CMake. It should be version 2.8.

$> sudo apt-get install cmake

• Install curl.

$> sudo apt-get install curl

• Install ccmake, the curses GUI for cmake.

$> sudo apt-get install cmake-curses-gui

• Install Git (and gitk, a useful GUI). You'll need to configure it, too. Check out Configuring Git.

$> sudo apt-get install git-core gitk

• Install Sun Java.

$> sudo add-apt-repository ppa:sun-java-community-team/sun-java6
$> sudo apt-get update
$> sudo apt-get install sun-java6-jdk $> sudo update-java-alternatives -s java-6-sun

Tab through the agreement and accept.

• Install python2.6-dev (you already get the non-dev one from build-essential)

$> sudo apt-get install python2.6-dev

• Install libmpfr1ldbl, a legacy version of libmpfr needed for gcc to work

$> sudo apt-get install libmpfr1ldbl

• Install Boost (libraries that our code depends on)

$> sudo apt-get install libboost-dev libboost-python-dev libboost-signals-dev

• Install ZLib (compression)

$> sudo apt-get install zlib1g-dev

• Install ant so that you can build the tool.

$> sudo apt-get install ant

Optional: Install ccache

$> sudo apt-get install ccache

Note: If you'd prefer to use aptitude instead of apt-get (biased comparison here), first run

$> sudo apt-get install aptitude

and replace all apt-gets above with aptitude

2. Setup Your .bashrc

Add the following lines to ~/.bashrc:

export AL_DIR=/usr/local/nao
export NBITES_DIR=/home/[your_username]/nbites
export LD_LIBRARY_PATH=/home/[your_username]/nbites/ext/lib:$LD_LIBRARY_PATH
export PATH=/home/[your_username]/nbites/ext/bin:$PATH

Assuming that your nbites folder is located in your user directory. Change the path if it is located somewhere else.

In other words, run

$> pico ~/.bashrc

Then paste the lines above into the file. You can add a comment, prefaced with a #, to remind yourself that those lines are for RoboCup.

3. Install NaoQi

Download the latest SDK from the server, link here.

Extract this file and move it to a suitable place, usually /usr/local/nao-[version]. This location may change based on personal preference. In other words, run, in the directory where you downloaded the file

$> tar -xvzf [filename].tar.gz

Then move the file using

$> sudo mv [extracted file] /usr/local/nao-1.10.44
if your version is 1.10.44.

Finally, create a symlink for the directory. This connects it to the AL_DIR variable you set in .bashrc.

$> sudo ln -s /usr/local/nao-1.10.44/ /usr/local/nao

Also download the ext and place it in your nbites folder. So find the .tar.gz file you just downloaded and run:

$> tar -xvzf ext-nbites-linux-tar.gz
$> mv ext ~/nbites/ext

or whatever the path is to your nbites folder.

Note: If you're using 64 bit Linux, you also need the 64-bit cross tool chain.

4. Setup Git and Get the Source##

Move on to Configuring Git so you can get our source code and start working!