Changes between Version 47 and Version 48 of Internal/OpenFlow/HostSetup

Timestamp:

Sep 23, 2011, 9:57:40 PM (13 years ago)

Author:

akoshibe

Comment:

—

Internal/OpenFlow/HostSetup

@@ -1 +1 @@
 [wiki:Internal/OpenFlow/ return to OpenFlow index]
+= NetFPGA !OpenFlow switch =
+According to the guides, !OpenVswitch provides a kenel implementation of the OF switch, whereas Stanford's reference switch is purely userspace. The former is faster, the latter more customizable.
+
+This is the latest set of instructions for installing NetFPGA drivers on Ubuntu (10.10), and making it work as an !OpenFlow switch. It is assumed that your working directory is /opt/.
+== I. NetFPGA setup ==
+=== 1.1 Download sources/dependencies ===
+`cd` to /opt/ and fetch the following:
+
+ * netfpga_full_2_2_0.tar.gz from: 
+  http://www.netfpga.org/releases/netfpga_full_2_2_0.tar.gz [[BR]]
+  REF: http://netfpga.org/foswiki/NetFPGA/OneGig/Releases
+
+ * netfpga_openflow_switch_1_0_0-4.tar.gz from:
+  http://netfpga.org/beta/distributions/netfpga_openflow_switch_1_0_0-4.tar.gz [[BR]]
+  REF: http://netfpga.org/foswiki/bin/view/NetFPGA/OneGig/OpenFlowNetFPGA100
+
+ * dependencies
+{{{
+apt-get update
+apt-get install build-essential linux-headers-`uname -r` ncurses-dev libnet1-dev libxml-simple-perl libio-interface-perl liblist-moreutils-perl liberror-perl git-core libpcap0.8 libpcap0.8-dev
+}}}
+=== 1.2 Compatibility fixes ===
+The following changes have to be made in order to compile the drivers on Ubuntu.
+ * Add the following symlinks:
+{{{
+ln /usr/bin/lspci /sbin/lspci
+ln /usr/bin/setpci /sbin/setpci
+}}}
+
+ * /opt/netfpga/lib/C/kernel/nf2util.h : add in the main #ifdef block:
+{{{
+// Replace SA_SHIRQ with IRQF_SHARED on newer kernels
+#ifndef SA_SHIRQ
+#define SA_SHIRQ IRQF_SHARED
+#endif
+}}}
+
+ * /etc/default/grub: add "vmalloc=512m" to GRUB_CMDLINE_LINUX_DEFAULT and do `update-grub`
+
+For the kernel: 
+ * If using kernel version 2.6.35-25, upgrade to 2.6.35 (`uname -ar` should show you which one you are running):
+{{{
+apt-get install linux-headers-2.6.35-30-generic linux-image-2.6.35-30-generic
+}}}
+
+ * Reboot. After reboot, check that the kernel flags are correct:
+{{{
+dmesg | grep vmalloc
+[    0.000000] Kernel command line: BOOT_IMAGE=/boot/vmlinuz-2.6.35-30-generic root=UUID=c90285a2-48de-4ab0-950f-241817516ad8 ro vmalloc=512m console=tty0 console=ttyS0,115200n8
+[    0.000000]     vmalloc : 0xdf7fe000 - 0xff7fe000   ( 512 MB)
+}}}
+
+=== 1.3 Compile drivers ===
+ * export environment variables:
+{{{
+export NF_ROOT=/opt/netfpga  #(wherever your netfpga base files are)
+source ${NF_ROOT}/bin/nf_profile
+}}}
+ 
+ * from /opt/netfpga: `make`; `make install`
+
+After compilation, load kernel module with `modprobe nf2`. If all goes well, you should see the an entry if you check with `lsmod | grep nf2`. At this point, you can load bitfiles and such by first running `cpci_reprogram` and then using nf_download. You should see something like this:
+{{{
+# cpci_reprogram.pl --all
+Loading the CPCI Reprogrammer on NetFPGA 0
+Loading the CPCI on NetFPGA 0
+CPCI on NetFPGA 0 has been successfully reprogrammed
+# nf_download /opt/netfpga/bitfiles/reference_switch.bit
+Found net device: nf2c0
+Bit file built from: nf2_top_par.ncd;HW_TIMEOUT=FALSE
+Part: 2vp50ff1152
+Date: 2011/ 1/20
+Time:  6: 8:48
+Error Registers: 0
+Good, after resetting programming interface the FIFO is empty
+Download completed -  2377668 bytes. (expected 2377668).
+DONE went high - chip has been successfully programmed.
+CPCI Information
+----------------
+Version: 4 (rev 1)
+
+Device (Virtex) Information
+---------------------------
+Project directory: reference_switch
+Project name: Reference Switch
+Project description: Reference Switch
+
+Device ID: 3
+Version: 1.0.0
+Built against CPCI version: 4 (rev 1)
+
+Virtex design compiled against active CPCI version
+}}}
+
+== II. !OpenFlow setup ==
+=== 2.1 dependencies ===
+ * packages:
+{{{
+apt-get install autoconf libtool
+}}}
+
+ * Use git to pull NetFPGA-specific !OpenFlow sources to /opt/:
+{{{
+git clone git://openflowswitch.org/openflow.git
+cd openflow
+git checkout -b 1.0.0-netfpga origin/devel/tyabe/1.0.0-netfpga
+}}}
+=== 2.2 build !OpenFlow ===
+{{{
+./boot.sh
+cd ./hw-lib/nf2
+wget http://openflowswitch.org/downloads/netfpga/openflow_switch.bit.100_3.tar.gz
+tar zxvf openflow_switch.bit.100_3.tar.gz ==> we need newer one from NF site:http://www.netfpga.org/releases/netfpga_openflow_switch_1_0_0-3.tar.gz
+cd ../../
+./configure --enable-hw-tables=nf2
+make
+make install
+}}}
+
+After compilation, copy of_start.sh and of_stop.sh from /opt/netfpga/projects/openflow_switch/sw/. 
+
+----
+See below for old instructions. 
+----
 = Setting up NetFPGA hosts: Ubuntu 10.04 = 
 Current Ubuntu NetFPGAs run Ubuntu version 8.04 and !OpenFlow ver. 1.0. Here we try to move to newer distributions w/ !OpenFlow Ver. 1.0. The hardware we use here is the NetFPGA cube, another version of the NetFPGA pre-built solution. As per the [http://www.openflowswitch.org/wk/index.php/CentOS_NetFPGA_Install !OpenFlow portion of the setup], a user named 'openflow' with root privs was added for this purpose.