Environment Setup

The following instructions will guide you through how to set up the environment for the programming assignments. The first set of instructions is for working with a local machine or VM running Ubuntu. We also provide an Amazon EC2 AMI image with everything set up for people would like to run the lab on EC2 (ami-96139ba6, Oregon Region). You can find instructions on how to use an EC2 AMI image below.

Use Your Own Ubuntu Machine

Install Needed Tools

sudo apt-get update
sudo apt-get install -y git vim-nox python-setuptools flex bison traceroute

Install Mininet

cd ~
git clone git://github.com/mininet/mininet
cd mininet
git checkout remotes/origin/class/cs244
./util/install.sh -fnv

Install POX

cd ~
git clone http://github.com/noxrepo/pox

Install ltprotocol

cd ~
git clone git://github.com/dound/ltprotocol.git
cd ltprotocol 
sudo python setup.py install

Use Amazon EC2

The assignments only require a t1.micro instance, for which Amazon provides 750 free usage hours per month.

Launch an Instance with the provided AMI Image

• Go to AWS Console
• Switch to "Oregon" region, you can do so by pull down the region menu on the upper-right corner. The default is N. Virginia.
• Click on "Launch an instance", then choose "Classic Wizard"
• On the "Community AMIs", search for "ami-96139ba6". You should see an image with the Manifest of "Mininet_assignments".
• Select the image, then keep clicking "Continue" on the next few page, until the page ask you to select your key pairs.
• Choose the key pair you would like to login to your EC2 instance, then click on "Continue".
• At the final page, you can find an "Launch" button. Click it and you are done!
• Go to "Security Groups", select "default", then click on "Inbound" tab.
• Select "SSH" from "Create a new rule" drop down.
• Click "Add Rule" then "Apply Rule Changes"
• Then use your key pair to login to your EC2 instance.

> ssh -Y -i <Your KeyPair> ubuntu@<your EC2 domain name>

The Image contains the starter code for all the assignments.