Changes between Version 16 and Version 17 of Internal/OpenFlow/HostSetup

Timestamp:

Jan 29, 2010, 11:29:24 PM (15 years ago)

Author:

akoshibe

Comment:

—

Internal/OpenFlow/HostSetup

@@ -242 +242 @@
 4. Install dependencies for Ubuntu compatibility, as per the [http://netfpga.org/foswiki/bin/view/NetFPGA/OneGig/UbuntuCompatibility compatibility page]. The packages are:
 
+== 2. Installing NetFPGA Drivers ==
+Steps described by the NetFPGA tunneling page:
+ 1. Install base package
+ 2. Install !OpenFlow components
+
+=== 1. Installing base package ===
+
+1. Download the tarballs from http://netfpga.org/beta/distributions/  [[BR]]
+For this you need a !FosWiki account (register [http://www.netfpga.org/foswiki/bin/view/System/UserRegistration?skin= here]). Download the newest netfpga_base_beta package (currently 2.0.0). Untar:
+   
+ tar -xvf netfpga_base_beta_2_0_0.tar.gz 
+   
+Untarring the package will create the directory NF2.  
+
+2. Edit files/ symlinks as per compatibility page [[BR]]
+
+Create links:
+{{{
+ln /usr/bin/lspci /sbin/lspci
+ln /usr/bin/setpci /sbin/setpci
+ln -s /usr/lib/libpcap.so.0.8 /usr/lib/libpcap.so.0.8.3
+}}}
+
+test_loopback_drop/run has been renamed run.pl in the most recent package. In this file you just need to change 'usleep 250' to 'sleep 0.00025'.  
+
+NF2/lib/C/kernel/Makefile is already in working condition - you don't need to modify it. 
+
+*Stopped at this point: The IRQF_SHARED flag is deprecated in kernels greater than 2.6.24. Instead, the SA_SHIRQ flag is used in include/linux/interrupt.h . in Ubuntu compatibility page**    
+
+3. Allocate more kernel memory [[BR]]
+The NetFPGA requires 256M memory allocated. This can be done through /boot/grub/menu.lst on older kernels. For the newer versions of Ubuntu (e.g. 9.10), which uses Grub 2, you need to edit /boot/grub/grub.cfg from 
+{{{
+GRUB_CMDLINE_LINUX_DEFAULT="quiet splash
+}}}
+to
+{{{
+GRUB_CMDLINE_LINUX_DEFAULT="vmalloc=256M
+}}}
+
+4. Edit and run user_account_setup.pl [[BR]]
+The script sets environmental variables. It is located under /NF2/lib/scripts/user_account_setup/ . Running it as is will throw an error saying
+
+ cat: /usr/local/NF2/bashrc_addon: No such file or directory   
+ 
+The easiest thing to do is to edit the script to contain the exact path to your NF2 directory and bashrc_addon:
+{{{
+else
+{
+  print "Copying the NF2 directory to your user account\n";
+  `cp -r /home/netfpga/NF2 ~`;
+}
+
+print "Adding the NetFPGA Enviornment Variables to your .bashrc\n";
+`cat /home/netfpga/NF2/bashrc_addon >> ~/.bashrc\n`;
+}}} 
+Then it will run correctly (here NF2 is already in the home directory)
+{{{
+$ ./user_account_setup.pl NF2 directory already exists copy has been canceled
+Adding the NetFPGA Enviornment Variables to your .bashrc
+}}}
+
+
+trying to use the 9.10 compatible stuff, found in http://www.netfpga.org/foswiki/bin/view/NetFPGA/OneGig/RealTimeSwitch
+
+----
+----
+= Installing Ubuntu, ~~take 3~~ take 4 = 
+After installing 9.10 server (AMD64) and 9.10 server 32 bit, we realized that there may be a "few" complications coming from the changes that were made in the more recent versions of Ubuntu (e.g. Grub 2, discarding "antiquated" libraries, ect), so things were rolled back to installing Ubuntu 9.04 server 32 bit. This should simplify *many* things. Hopefully. 
+
+== 1. Installation of the OS ==
+1. Go to the BIOS settings, make CD drive highest boot priority
+
+2. Follow the default choices given for intallation, save the following few:
+ 
+ * no setup of LVM for disk partitioning
+ * additional packages - install OpenSSH server
+ * hostname: netfpga1
+ * user: netfpga
+ 
+3. When rebooting, go back to the BIOS settings to make sure the HDD is included in the boot priority list. 'x' adds excluded devices to the boot priority list.   
+
+4. Who's afraid of a little command line? If you are, y' shoulda stuck with desktop edition. 
+
+=== Host info ===
+From past experience, the following info will come in handy when troubleshooting stuff... 
+ * uname -a shows: 2.6.28-11-server i686 GNU/Linux
+ * IP address: 192.168.203.187 (DHCP - May change)
+ * bootloader: grub 
+ 
+== 2. Installing drivers (NetFPGA) ==
+The host is named "Netfpga1" because it will be a NetFPGA host. So this is sort of important.
+
+ * Ubuntu Compatibility 
+ * http://netfpga.org/foswiki/bin/view/NetFPGA/OneGig/Guide
+
+0. Get a Foswiki account so you can download the packages you need at their [http://www.netfpga.org/foswiki/bin/view/System/UserRegistration?skin= registration page].
+
+1. Update packages, then install the following dependencies as per the [http://netfpga.org/foswiki/bin/view/NetFPGA/OneGig/UbuntuCompatibility Comaptibility page]:
   * build-essential
   * linux-headers-`uname -r`
@@ -255 +353 @@
   * libpcap0.8-dev
 
-== 2. Installing NetFPGA Drivers ==
-Steps described by the NetFPGA tunneling page:
- 1. Install base package
- 2. Install !OpenFlow components
-
-=== 1. Installing base package ===
-
-1. Download the tarballs from http://netfpga.org/beta/distributions/  [[BR]]
-For this you need a !FosWiki account (register [http://www.netfpga.org/foswiki/bin/view/System/UserRegistration?skin= here]). Download the newest netfpga_base_beta package (currently 2.0.0). Untar:
-   
- tar -xvf netfpga_base_beta_2_0_0.tar.gz 
-   
-Untarring the package will create the directory NF2.  
-
-2. Edit files/ symlinks as per compatibility page [[BR]]
-
-Create links:
+2. Download the base package. The newest is netfpga_base_beta_2_0_0. Untar:
+{{{
+tar xvf netfpga_base_beta_2_0_0.tar.gz
+}}}   
+This will create a directory called NF2 in your home directory. 
+
+3. create symlinks:
 {{{
 ln /usr/bin/lspci /sbin/lspci
 ln /usr/bin/setpci /sbin/setpci
 ln -s /usr/lib/libpcap.so.0.8 /usr/lib/libpcap.so.0.8.3
-}}}
-
-test_loopback_drop/run has been renamed run.pl in the most recent package. In this file you just need to change 'usleep 250' to 'sleep 0.00025'.  
-
-NF2/lib/C/kernel/Makefile is already in working condition - you don't need to modify it. 
-
-*Stopped at this point: The IRQF_SHARED flag is deprecated in kernels greater than 2.6.24. Instead, the SA_SHIRQ flag is used in include/linux/interrupt.h . in Ubuntu compatibility page**    
-
-3. Allocate more kernel memory [[BR]]
-The NetFPGA requires 256M memory allocated. This can be done through /boot/grub/menu.lst on older kernels. For the newer versions of Ubuntu (e.g. 9.10), which uses Grub 2, you need to edit /boot/grub/grub.cfg from 
-{{{
-GRUB_CMDLINE_LINUX_DEFAULT="quiet splash
-}}}
-to
-{{{
-GRUB_CMDLINE_LINUX_DEFAULT="vmalloc=256M
-}}}
-
-4. Edit and run user_account_setup.pl [[BR]]
-The script sets environmental variables. It is located under /NF2/lib/scripts/user_account_setup/ . Running it as is will throw an error saying
-
- cat: /usr/local/NF2/bashrc_addon: No such file or directory   
- 
-The easiest thing to do is to edit the script to contain the exact path to your NF2 directory and bashrc_addon:
-{{{
-else
-{
-  print "Copying the NF2 directory to your user account\n";
-  `cp -r /home/netfpga/NF2 ~`;
-}
-
-print "Adding the NetFPGA Enviornment Variables to your .bashrc\n";
-`cat /home/netfpga/NF2/bashrc_addon >> ~/.bashrc\n`;
 }}} 
-Then it will run correctly (here NF2 is already in the home directory)
-{{{
-$ ./user_account_setup.pl NF2 directory already exists copy has been canceled
-Adding the NetFPGA Enviornment Variables to your .bashrc
-}}}
-
-**stopped here: The IRQF_SHARED flag is deprecated in kernels greater than 2.6.24. Instead, the SA_SHIRQ flag is used in include/linux/interrupt.h . in Ubuntu compatibility page **
-----
-= METHOD 2 =
-
-trying to use the 9.10 compatible stuff, found in http://www.netfpga.org/foswiki/bin/view/NetFPGA/OneGig/RealTimeSwitch
-
+
+4. Edit files by following the compatibility page. Some of the stuff there is outdated, so keep an eye out for the following:
+
+ * /test_loopback_drop/run is /test_loopback_drop/run.pl 
+ * edit "usleep 250" to "sleep 0.00025" in /test_loopback_drop/run.pl 
+ * Don't change anything on /NF2/lib/C/kernel/Makefile
+ * Likewise, NF2/lib/C/download/nf2_download.c need not be edited.  
+
+5. Edit /boot/grub/menu.lst to allocate more kernel memory:
+{{{
+title    Ubuntu 9.04, kernel 2.6.28-16-generic 
+uuid    (BIG number here)
+kernel  /vmlinuz-2.6.28-16-generic root=UUID=(BIG number here) ro quiet splash vmalloc=256M
+}}}
+
+6. Edit rkd.cc to include limits.h
+
+7. Replace asm/semaphores with linux/semaphores 
+
+8. `make` and `make install` in user's NF2 directory (you need to be root)
+
+== Testing that NetFPGA works ==
+1. Reprogram CPCI
+ 
+In cpci_reprogram.pl line 216, change the offset from 5 to 4:
+{{{
+# Search for the NetFPGA device ID
+                if ($words[4] eq $NF2_device_id)           <<---over here
+                {
+                        push (@device_list, $words[0]);
+                }
+}}}  
+
+Then run cpci_reprogram.pl (run from user home directory):
+{{{
+/home/netfpga/NF2/lib/scripts/cpci_reprogram/cpci_reprogram.pl --all
+}}} 
+Add the same command to /etc/rc.local so this is done automatically each time the machine is rebooted. 
+
+2. Rename interfaces. 
+
+Since you need eth1 and 2 for the regression test, you need to change eth0 to eth2. Change "eth0" to "eth2" in /etc/udev/rules.d/70-persistent-net.rules so it looks similar to this:
+{{{
+SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:30:48:b1:9d:a9", ATTR{type}=="1", KERNEL=="eth*", NAME="eth1"
+
+# PCI device 0x8086:0x109a (e1000e)
+SUBSYSTEM=="net", ACTION=="add", DRIVERS=="?*", ATTR{address}=="00:30:48:b1:9d:a8", ATTR{type}=="1", KERNEL=="eth*", NAME="eth2"
+}}}    
+ 
+The changes will take effect after you reboot the machine. 
+
+
+