Join GitHub today
GitHub is home to over 28 million developers working together to host and review code, manage projects, and build software together.Sign up
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. (Note: We strongly encourage you to use EC2 AMI image, since you can avoid version problems as POX/Mininet are open source projects and will continue to evolve.)
Using Your Own Ubuntu Machine or VM
Install Needed Tools
sudo apt-get update sudo apt-get install -y git vim-nox python-setuptools python-all-dev flex bison traceroute
cd ~ git clone git://github.com/mininet/mininet cd mininet ./util/install.sh -fnv
Note: older versions of the assignments required you to check out an older version of Mininet before running
install.sh, but this should no longer be necessary:
git checkout remotes/origin/class/cs244 ./util/install.sh -fnv ...
cd ~ git clone http://github.com/noxrepo/pox
cd ~ git clone git://github.com/dound/ltprotocol.git cd ltprotocol sudo python setup.py install
Using 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.