Changes between Version 6 and Version 7 of Tutorials/m0SDN/aHowTo

Timestamp:

Aug 13, 2009, 11:48:31 PM (15 years ago)

Author:

akoshibe

Comment:

—

Tutorials/m0SDN/aHowTo

@@ -3 +3 @@
 
 
-=== !OpenFlow Protocol ===
+== !OpenFlow Protocol ==
 !OpenFlow is a protocol that allows for the creation of overlay networks over pre-existing network infrastructure. This allows a researcher to run experiments on production networks without the fear of affecting any of the legacy installations or setups, while having control over how data is handled across the network.
 [[BR]]  
@@ -12 +12 @@
 
 
-=== The Testbed ===
-Sandbox 9 consists of three nodes connected to the SB9 Console through a !OpenFlow enabled switch. The network topology is shown below:
+== The Testbed ==
+Sandbox 9 consists of three nodes connected to the SB9 Console through a !OpenFlow enabled switch. The !OpenFlow enabled NEC IP8800/S3640-48T2XW switch currently runs firmware supporting !OpenFlow v0.8.9. The switch is pre-configured so that ports 25-36 (the data VLAN, in green) is an !OpenFlow virtual switch that listens for a controller running on the SB9 Console. The network topology is shown below:
 [[BR]]
 [[BR]]
 [[Image(wiki:Documentation/OpenFlow/OFHowTo:OFSetup.jpg, 450)]]  
+    
 
-=== The switch ===
-One of the centerpieces to the setup is the !OpenFlow enabled NEC IP8800/S3640-48T2XW switch running firmware supporting !OpenFlow v0.8.9. The switch is pre-configured so that ports 25-36 (the data VLAN) is an !OpenFlow virtual switch that listens to a controller running on the Console. The configurations can be altered by using the `setvsi` command in the switch's command-line interface. 
-The details behind configuring the virtual switch(es) on the IP8800 can be found [wiki:Documentation/OpenFlow/VirtualSwitch here]. 
-    
-=== The Controller ===
-''' Installing the controller ''' [[BR]]
-The !OpenFlow reference System (v0.8.9r2) and NOX-core (v0.5.0) have been successfully installed and tested on the Console. These can be downloaded from the following places:
+== Installing the controller == 
+Two controllers, one from the !OpenFlow reference System (v0.8.9r2) and another from NOX-core (v0.5.0), have been successfully installed and tested on the Console. These can be downloaded from the following places:
 
  * !OpenFlow reference system: http://www.openflowswitch.org/wp/downloads/
@@ -31 +27 @@
 The former is a simple implementation that comes with a few tests; latter is a full-blown network operating system/ development tool that comes with a Network API that can be used to write and develop your own controller in C++ or Python.
 
-''' Starting the controller ''' [[BR]]
+Both can also be installed using Git. Git can be installed with the following command:   
+{{{
+apt-get install git-core   
+}}}
+
+=== Installing the !OpenFlow Reference System ===
+While presented, it is not recommended to install from tarball. 
+The detailed instructions may be found here: http://www.openflowswitch.org/wp/getstarted/
+
+1. Download software and required packages. If using git: 
+{{{
+sudo apt-get install git-core automake m4 pkg-config libtool
+git clone http://openflowswitch.org/openflow
+cd openflow
+./boot.sh
+}}}
+if installing from tarball:
+{{{
+mkdir openflow
+cd openflow
+wget http://openflowswitch.org/downloads/openflow-0.9.0.tar.gz
+tar xzf openflow-0.9.0.tar.gz
+cd openflow-0.9.0
+sudo apt-get install gcc linux-headers-`uname -r`
+}}}
+2. Make and install.
+{{{
+./configure --with-l26=/lib/modules/`uname -r`/build
+make
+make install
+}}}
+
+=== Installing NOX  ===
+It is not only recommended but also much simpler to use git to install NOX. Therefore the following instructions assume you are using git. The full instructions are found at noxrepo.org:  http://noxrepo.org/manual/installation.html [[BR]]
+
+''' Dependencies ''' [[BR]]
+NOX requires the following packages to be installed on the Console:
+ * GNU Libtool (libtool)
+ * Boost C++ libraries (libboost1.35-dev)
+ * Apache HTTP Server (apache2)
+ * Xerces C++ parser (libxerces-c28)
+ * Xerces development files (libxerces-c2-dev)
+ * SSL development libraries (libssl-dev)
+ * SQLite 3 development files (libsqlite3-dev)
+ * Simple JSON for Python (python-simplejson)
+
+If all dependencies are taken care of, NOX will install with the following steps. 
+{{{
+cd 
+git clone git://noxrepo.org/noxcore
+cd noxcore/
+./boot.sh
+mkdir build/
+cd build/
+../configure --with-python=yes
+make
+make check 
+}}}
+
+== Starting the controller ==
 Both commands start the controller and establish a connection with the !OpenFlow switch. The -v is for verbose. -h for both will give you the help files for the controllers. In the reference system, the controller is found under .../openflow/controller/
 {{{
@@ -41 +96 @@
 }}} 
 
+=== Development ===
+The files defining !OpenFlow Protocol can be found in the following locations:
+ * !OpenFlow reference system:  openflow/include/openflow/openflow.h
+ * NOX: noxcore/src/include/openflow.hh
 
-
-
+In addition, NOX provides a [http://noxrepo.org/manual/app.html Web API] that allows you to do development in C++ or Python.