#!/usr/bin/env bash # Mininet install script for Ubuntu (and Debian Lenny) # Brandon Heller (brandonh@stanford.edu) # Fail on error set -e # Fail on unset var usage set -o nounset # Location of CONFIG_NET_NS-enabled kernel(s) KERNEL_LOC=http://www.openflow.org/downloads/mininet # Attempt to identify Linux release DIST=Unknown RELEASE=Unknown CODENAME=Unknown ARCH=`uname -m` if [ "$ARCH" = "x86_64" ]; then ARCH="amd64"; fi if [ "$ARCH" = "i686" ]; then ARCH="i386"; fi test -e /etc/debian_version && DIST="Debian" grep Ubuntu /etc/lsb-release &> /dev/null && DIST="Ubuntu" if [ "$DIST" = "Ubuntu" ] || [ "$DIST" = "Debian" ]; then install='sudo apt-get -y install' remove='sudo apt-get -y remove' pkginst='sudo dpkg -i' # Prereqs for this script if ! which lsb_release &> /dev/null; then $install lsb-release fi if ! which bc &> /dev/null; then $install bc fi fi if which lsb_release &> /dev/null; then DIST=`lsb_release -is` RELEASE=`lsb_release -rs` CODENAME=`lsb_release -cs` fi echo "Detected Linux distribution: $DIST $RELEASE $CODENAME $ARCH" # Kernel params if [ "$DIST" = "Ubuntu" ]; then if [ "$RELEASE" = "10.04" ]; then KERNEL_NAME='3.0.0-15-generic' else KERNEL_NAME=`uname -r` fi KERNEL_HEADERS=linux-headers-${KERNEL_NAME} elif [ "$DIST" = "Debian" ] && [ "$ARCH" = "i386" ] && [ "$CODENAME" = "lenny" ]; then KERNEL_NAME=2.6.33.1-mininet KERNEL_HEADERS=linux-headers-${KERNEL_NAME}_${KERNEL_NAME}-10.00.Custom_i386.deb KERNEL_IMAGE=linux-image-${KERNEL_NAME}_${KERNEL_NAME}-10.00.Custom_i386.deb else echo "Install.sh currently only supports Ubuntu and Debian Lenny i386." exit 1 fi # More distribution info DIST_LC=`echo $DIST | tr [A-Z] [a-z]` # as lower case # Kernel Deb pkg to be removed: KERNEL_IMAGE_OLD=linux-image-2.6.26-33-generic DRIVERS_DIR=/lib/modules/${KERNEL_NAME}/kernel/drivers/net OVS_RELEASE=1.4.0 OVS_PACKAGE_LOC=https://github.com/downloads/mininet/mininet OVS_BUILDSUFFIX=-ignore # was -2 OVS_PACKAGE_NAME=ovs-$OVS_RELEASE-core-$DIST_LC-$RELEASE-$ARCH$OVS_BUILDSUFFIX.tar OVS_SRC=~/openvswitch OVS_TAG=v$OVS_RELEASE OVS_BUILD=$OVS_SRC/build-$KERNEL_NAME OVS_KMODS=($OVS_BUILD/datapath/linux/{openvswitch_mod.ko,brcompat_mod.ko}) function kernel { echo "Install Mininet-compatible kernel if necessary" sudo apt-get update if [ "$DIST" = "Ubuntu" ] && [ "$RELEASE" = "10.04" ]; then $install linux-image-$KERNEL_NAME elif [ "$DIST" = "Debian" ]; then # The easy approach: download pre-built linux-image and linux-headers packages: wget -c $KERNEL_LOC/$KERNEL_HEADERS wget -c $KERNEL_LOC/$KERNEL_IMAGE # Install custom linux headers and image: $pkginst $KERNEL_IMAGE $KERNEL_HEADERS # The next two steps are to work around a bug in newer versions of # kernel-package, which fails to add initrd images with the latest kernels. # See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=525032 # Generate initrd image if the .deb didn't install it: if ! test -e /boot/initrd.img-${KERNEL_NAME}; then sudo update-initramfs -c -k ${KERNEL_NAME} fi # Ensure /boot/grub/menu.lst boots with initrd image: sudo update-grub # The default should be the new kernel. Otherwise, you may need to modify # /boot/grub/menu.lst to set the default to the entry corresponding to the # kernel you just installed. fi } function kernel_clean { echo "Cleaning kernel..." # To save disk space, remove previous kernel if ! $remove $KERNEL_IMAGE_OLD; then echo $KERNEL_IMAGE_OLD not installed. fi # Also remove downloaded packages: rm -f ~/linux-headers-* ~/linux-image-* } # Install Mininet deps function mn_deps { echo "Installing Mininet dependencies" $install gcc make screen psmisc xterm ssh iperf iproute telnet \ python-setuptools python-networkx cgroup-bin ethtool help2man \ pyflakes pylint pep8 if [ "$DIST" = "Ubuntu" ] && [ "$RELEASE" = "10.04" ]; then echo "Upgrading networkx to avoid deprecation warning" sudo easy_install --upgrade networkx fi # Add sysctl parameters as noted in the INSTALL file to increase kernel # limits to support larger setups: sudo su -c "cat $HOME/mininet/util/sysctl_addon >> /etc/sysctl.conf" # Load new sysctl settings: sudo sysctl -p echo "Installing Mininet core" pushd ~/mininet sudo make install popd } # The following will cause a full OF install, covering: # -user switch # The instructions below are an abbreviated version from # http://www.openflowswitch.org/wk/index.php/Debian_Install # ... modified to use Debian Lenny rather than unstable. function of { echo "Installing OpenFlow reference implementation..." cd ~/ $install git-core autoconf automake autotools-dev pkg-config \ make gcc libtool libc6-dev git clone git://openflowswitch.org/openflow.git cd ~/openflow # Patch controller to handle more than 16 switches patch -p1 < ~/mininet/util/openflow-patches/controller.patch # Resume the install: ./boot.sh ./configure make sudo make install # Remove avahi-daemon, which may cause unwanted discovery packets to be # sent during tests, near link status changes: $remove avahi-daemon # Disable IPv6. Add to /etc/modprobe.d/blacklist: if [ "$DIST" = "Ubuntu" ]; then BLACKLIST=/etc/modprobe.d/blacklist.conf else BLACKLIST=/etc/modprobe.d/blacklist fi sudo sh -c "echo 'blacklist net-pf-10\nblacklist ipv6' >> $BLACKLIST" cd ~ } function wireshark { echo "Installing Wireshark dissector..." sudo apt-get install -y wireshark libgtk2.0-dev if [ "$DIST" = "Ubuntu" ] && [ "$RELEASE" != "10.04" ]; then # Install newer version sudo apt-get install -y scons mercurial libglib2.0-dev sudo apt-get install -y libwiretap-dev libwireshark-dev cd ~ hg clone https://bitbucket.org/barnstorm/of-dissector cd of-dissector/src export WIRESHARK=/usr/include/wireshark scons # libwireshark0/ on 11.04; libwireshark1/ on later WSDIR=`ls -d /usr/lib/wireshark/libwireshark* | head -1` WSPLUGDIR=$WSDIR/plugins/ sudo cp openflow.so $WSPLUGDIR echo "Copied openflow plugin to $WSPLUGDIR" else # Install older version from reference source cd ~/openflow/utilities/wireshark_dissectors/openflow make sudo make install fi # Copy coloring rules: OF is white-on-blue: mkdir -p ~/.wireshark cp ~/mininet/util/colorfilters ~/.wireshark } # Install Open vSwitch # Instructions derived from OVS INSTALL, INSTALL.OpenFlow and README files. function ovs { echo "Installing Open vSwitch..." # Required for module build/dkms install $install $KERNEL_HEADERS ovspresent=0 # First see if we have packages # XXX wget -c seems to fail from github/amazon s3 cd /tmp if wget $OVS_PACKAGE_LOC/$OVS_PACKAGE_NAME 2> /dev/null; then $install patch dkms fakeroot python-argparse tar xf $OVS_PACKAGE_NAME orig=`tar tf $OVS_PACKAGE_NAME` # Now install packages in reasonable dependency order order='dkms common pki openvswitch-switch brcompat controller' pkgs="" for p in $order; do pkg=`echo "$orig" | grep $p` # Annoyingly, things seem to be missing without this flag $pkginst --force-confmiss $pkg done ovspresent=1 fi # Otherwise try distribution's OVS packages if [ "$DIST" = "Ubuntu" ] && [ `expr $RELEASE '>=' 11.10` = 1 ]; then if ! dpkg --get-selections | grep openvswitch-datapath; then # If you've already installed a datapath, assume you # know what you're doing and don't need dkms datapath. # Otherwise, install it. $install openvswitch-datapath-dkms fi if $install openvswitch-switch openvswitch-controller; then echo "Ignoring error installing openvswitch-controller" fi ovspresent=1 fi # Switch can run on its own, but # Mininet should control the controller if [ -e /etc/init.d/openvswitch-controller ]; then if sudo service openvswitch-controller stop; then echo "Stopped running controller" fi sudo update-rc.d openvswitch-controller disable fi if [ $ovspresent = 1 ]; then echo "Done (hopefully) installing packages" cd ~ return fi # Otherwise attempt to install from source $install pkg-config gcc make python-dev libssl-dev libtool if [ "$DIST" = "Debian" ]; then if [ "$CODENAME" = "lenny" ]; then $install git-core # Install Autoconf 2.63+ backport from Debian Backports repo: # Instructions from http://backports.org/dokuwiki/doku.php?id=instructions sudo su -c "echo 'deb http://www.backports.org/debian lenny-backports main contrib non-free' >> /etc/apt/sources.list" sudo apt-get update sudo apt-get -y --force-yes install debian-backports-keyring sudo apt-get -y --force-yes -t lenny-backports install autoconf fi else $install git fi # Install OVS from release cd ~/ git clone git://openvswitch.org/openvswitch $OVS_SRC cd $OVS_SRC git checkout $OVS_TAG ./boot.sh BUILDDIR=/lib/modules/${KERNEL_NAME}/build if [ ! -e $BUILDDIR ]; then echo "Creating build sdirectory $BUILDDIR" sudo mkdir -p $BUILDDIR fi opts="--with-linux=$BUILDDIR" mkdir -p $OVS_BUILD cd $OVS_BUILD ../configure $opts make sudo make install modprobe } function remove_ovs { pkgs=`dpkg --get-selections | grep openvswitch | awk '{ print $1;}'` echo "Removing existing Open vSwitch packages:" echo $pkgs if ! $remove $pkgs; then echo "Not all packages removed correctly" fi # For some reason this doesn't happen if scripts=`ls /etc/init.d/*openvswitch* 2>/dev/null`; then echo $scripts for s in $scripts; do s=$(basename $s) echo SCRIPT $s sudo service $s stop sudo rm -f /etc/init.d/$s sudo update-rc.d -f $s remove done fi echo "Done removing OVS" } # Install NOX with tutorial files function nox { echo "Installing NOX w/tutorial files..." # Install NOX deps: $install autoconf automake g++ libtool python python-twisted \ swig libssl-dev make if [ "$DIST" = "Debian" ]; then $install libboost1.35-dev elif [ "$DIST" = "Ubuntu" ]; then $install python-dev libboost-dev $install libboost-filesystem-dev $install libboost-test-dev fi # Install NOX optional deps: $install libsqlite3-dev python-simplejson # Fetch NOX destiny cd ~/ git clone https://github.com/noxrepo/nox-classic.git noxcore cd noxcore if ! git checkout -b destiny remotes/origin/destiny ; then echo "Did not check out a new destiny branch - assuming current branch is destiny" fi # Apply patches git checkout -b tutorial-destiny git am ~/mininet/util/nox-patches/*tutorial-port-nox-destiny*.patch if [ "$DIST" = "Ubuntu" ] && [ `expr $RELEASE '>=' 12.04` = 1 ]; then git am ~/mininet/util/nox-patches/*nox-ubuntu12-hacks.patch fi # Build ./boot.sh mkdir build cd build ../configure make -j3 #make check # Add NOX_CORE_DIR env var: sed -i -e 's|# for examples$|&\nexport NOX_CORE_DIR=~/noxcore/build/src|' ~/.bashrc # To verify this install: #cd ~/noxcore/build/src #./nox_core -v -i ptcp: } # "Install" POX function pox { echo "Installing POX into $HOME/pox..." cd ~ git clone https://github.com/noxrepo/pox.git } # Install OFtest function oftest { echo "Installing oftest..." # Install deps: $install tcpdump python-scapy # Install oftest: cd ~/ git clone git://github.com/floodlight/oftest } # Install cbench function cbench { echo "Installing cbench..." $install libsnmp-dev libpcap-dev libconfig-dev cd ~/ git clone git://openflow.org/oflops.git cd oflops sh boot.sh || true # possible error in autoreconf, so run twice sh boot.sh ./configure --with-openflow-src-dir=$HOME/openflow make sudo make install || true # make install fails; force past this } function other { echo "Doing other setup tasks..." # Enable command auto completion using sudo; modify ~/.bashrc: sed -i -e 's|# for examples$|&\ncomplete -cf sudo|' ~/.bashrc # Install tcpdump and tshark, cmd-line packet dump tools. Also install gitk, # a graphical git history viewer. $install tcpdump tshark gitk # Install common text editors $install vim nano emacs # Install NTP $install ntp # Set git to colorize everything. git config --global color.diff auto git config --global color.status auto git config --global color.branch auto # Reduce boot screen opt-out delay. Modify timeout in /boot/grub/menu.lst to 1: if [ "$DIST" = "Debian" ]; then sudo sed -i -e 's/^timeout.*$/timeout 1/' /boot/grub/menu.lst fi # Clean unneeded debs: rm -f ~/linux-headers-* ~/linux-image-* } # Script to copy built OVS kernel module to where modprobe will # find them automatically. Removes the need to keep an environment variable # for insmod usage, and works nicely with multiple kernel versions. # # The downside is that after each recompilation of OVS you'll need to # re-run this script. If you're using only one kernel version, then it may be # a good idea to use a symbolic link in place of the copy below. function modprobe { echo "Setting up modprobe for OVS kmod..." sudo cp $OVS_KMODS $DRIVERS_DIR sudo depmod -a ${KERNEL_NAME} } function all { echo "Running all commands..." kernel mn_deps of wireshark ovs # NOX-classic is deprecated, but you can install it manually if desired. # nox pox oftest cbench other echo "Please reboot, then run ./mininet/util/install.sh -c to remove unneeded packages." echo "Enjoy Mininet!" } # Restore disk space and remove sensitive files before shipping a VM. function vm_clean { echo "Cleaning VM..." sudo apt-get clean sudo rm -rf /tmp/* sudo rm -rf openvswitch*.tar.gz # Remove sensistive files history -c # note this won't work if you have multiple bash sessions rm -f ~/.bash_history # need to clear in memory and remove on disk rm -f ~/.ssh/id_rsa* ~/.ssh/known_hosts sudo rm -f ~/.ssh/authorized_keys* # Remove Mininet files #sudo rm -f /lib/modules/python2.5/site-packages/mininet* #sudo rm -f /usr/bin/mnexec # Clear optional dev script for SSH keychain load on boot rm -f ~/.bash_profile # Clear git changes git config --global user.name "None" git config --global user.email "None" # Remove mininet install script rm -f install-mininet.sh } function usage { printf 'Usage: %s [-abcdfhkmnprtvwx]\n\n' $(basename $0) >&2 printf 'This install script attempts to install useful packages\n' >&2 printf 'for Mininet. It should (hopefully) work on Ubuntu 11.10+\n' >&2 printf 'If you run into trouble, try\n' >&2 printf 'installing one thing at a time, and looking at the \n' >&2 printf 'specific installation function in this script.\n\n' >&2 printf 'options:\n' >&2 printf -- ' -a: (default) install (A)ll packages - good luck!\n' >&2 printf -- ' -b: install controller (B)enchmark (oflops)\n' >&2 printf -- ' -c: (C)lean up after kernel install\n' >&2 printf -- ' -d: (D)elete some sensitive files from a VM image\n' >&2 printf -- ' -f: install open(F)low\n' >&2 printf -- ' -h: print this (H)elp message\n' >&2 printf -- ' -k: install new (K)ernel\n' >&2 printf -- ' -m: install Open vSwitch kernel (M)odule from source dir\n' >&2 printf -- ' -n: install mini(N)et dependencies + core files\n' >&2 printf -- ' -p: install (P)OX OpenFlow Controller\n' >&2 printf -- ' -r: remove existing Open vSwitch packages\n' >&2 printf -- ' -t: install o(T)her stuff\n' >&2 printf -- ' -v: install open (V)switch\n' >&2 printf -- ' -w: install OpenFlow (w)ireshark dissector\n' >&2 printf -- ' -x: install NO(X) OpenFlow controller\n' >&2 exit 2 } if [ $# -eq 0 ] then all else while getopts 'abcdfhkmnprtvwx' OPTION do case $OPTION in a) all;; b) cbench;; c) kernel_clean;; d) vm_clean;; f) of;; h) usage;; k) kernel;; m) modprobe;; n) mn_deps;; p) pox;; r) remove_ovs;; t) other;; v) ovs;; w) wireshark;; x) nox;; ?) usage;; esac done shift $(($OPTIND - 1)) fi