IODS VM Bringup

Owned by Former user (Deleted)
Last updated: Aug 08, 2011Version comment

Table of Contents

Overview

This document briefly describes the steps that were taken to configure the VM for IODS, the Indigo Open Development System.

If you have an IODS VM, all these steps have been completed and the VM should be ready to build images. You do not need to refer to this document unless you are bringing up your own IODS server.

The instructions here should be applicable to a real server as well as a VM so long as the server has at least the capabilities described below.

VM Description

The VM was created using VMWare Fusion on a Mac running OS 10.6. The standard disk image for Ubuntu 11.04 server was used and the "automatic bring up" was selected for the install. The image was configured with 30 GB of hard drive space, 2 CPU cores and 1 GB of RAM. The network was installed with bridging using an IP address local to the host machine.

Host System

  • Installed ubuntu 11.04 server
  • user: indigo; password: indigo
  • changed /etc/hostname to iods
  • Added nopasswd to sudo
  • Installed packages 
    sudo apt-get update
sudo apt-get install -y openssh-server
sudo apt-get install -y emacs
sudo apt-get install -y firefox
sudo apt-get install -y git
sudo apt-get install -y build-essential
sudo apt-get install -y pkg-config
sudo apt-get install -y automake
sudo apt-get install -y libc6-i386
sudo apt-get install -y make
sudo apt-get install -y lib32z1-dev
sudo apt-get install -y lua5.1
sudo apt-get install -y wireshark
  • Build autoconf-2.63 from sourceftp://mirrors.kernel.org/gnu/autoconf/autoconf-2.63.tar.bz2

Also installed tftp as per (somewhat dated): http://www.davidsudjiman.info/2006/03/27/installing-and-setting-tftpd-in-ubuntu/

Tools

Suggested location is in /tools; alternative is $HOME/tools

  • cd /
  • sudo mkdir tools
  • cd tools
  • Download tools. These should be available from the same page you download the IODS VM image from. For building Pronto platforms, you need ELDK_4.2; for building Netgear platforms, you need iods-ntgr-bld.
  • You should end up with directories ELDK_4.2 and iods-ntgr-bld
  • Link tools to $HOME: cd ~; ln -s /tools .

OpenFlow for wireshark

The OpenFlow version included in the indigo build is missing some updates for the wireshark plugin. So the public version of OpenFlow 1.0 was installed to get this utility.

git clone git://gitosis.stanford.edu/openflow.git
cd utilities/wireshark_dissectors
make
sudo make install

I copied the plug in to the global wireshark plugin dir:

sudo cp /var/packet-openflow.so /usr/lib/wireshark/libwireshark0/plugins/

Get the IODS source code

The source is available from github.

cd ~
git clone git://github.com/bigswitch/iods.git

Build the source for all platforms

You may not need to build for all platforms.

cd ~/iods
source build-files/env
# Select the platforms you wish to build for
make gsm73xx lb9a lb8 lb4g

The results of each build are stored in the build-images/<platform> directory