Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/NFV/Ryu

Timestamp:

10/19/16 16:50:59 (8 years ago)

Author:

wyf@bu.edu

Comment:

--

GENIExperimenter/Tutorials/NFV/Ryu

@@ +1 @@
+= NFV Tutorial using Ryu =
+== Overview ==
+We provide another version of  the NFV tutorial using the Ryu controller (besides the POX controller).  The differences of the instructions comparing to the POX version are included in this wiki page, and you need to refer to the [wiki:GENIExperimenter/Tutorials/NFV POX version] tutorial when finishing this Ryu version tutorial. 
+
+== Tools ==
+-  [https://osrg.github.io/ryu/ Ryu controller],  and a tutorial about how to use the Ryu controller can be found [http://sdnhub.org/tutorials/ryu/ here] .  
+
+----
+== Part I: !Design/Setup ==
+      - First finish step 1-3 in this [wiki:GENIExperimenter/Tutorials/NFV/DesignSetup page].
+      - Then ssh to the VM for controller (reserved in Step 3.1), run the following to setup Ryu controller on this VM:
+          - '''cd ~''' 
+          - '''wget !http://csr.bu.edu/rina/grw-bu2016/nfv_ryu/install_ryu.sh'''
+          -  '''chmod 755 install_ryu.sh '''
+          -  '''./install_ryu.sh'''
+      - Run the following:  '''~/ryu/bin/ryu-manager --verbose ~/ryu/ryu/app/simple_switch.py'''  [[BR]] and if Ryu is installed correctly, you should see the output as follows: 
+
+{{{
+#!html
+<img src="http://csr.bu.edu/rina/grw-bu2016/nfv_ryu/pics/ryu.png" hspace=50>
+ }}}
+
+
+----
+
+== Part II: Execute ==
+
+=== 1.     Login to the hosts === 
+
+Open the following windows:
+  -      one window with ssh into ''controller''
+  -      one window with ssh into ''OVS''
+  -      one window with ssh into ''s1''
+  -      one window with ssh into ''VNF1''
+  -      one window with ssh into ''VNF2''
+  -      one window with ssh into ''destination''
+
+=== 2.     Configure and initialize services ===
+
+==== 2.1. Use a simple learning switch controller ====
+
+This is a very simple example where we are going to run a learning switch control to forward traffic from s1 to VNF1.[[BR]]
+
+      1.     Start a ping from s1 to VNF1 in the window of  s1, which should timeout, since there is no controller running.[[BR]]
+              '''ping vnf1 -c 10'''
+      2.     Run the following command to start the simple leaning controller:
+               '''~/ryu/bin/ryu-manager --verbose ~/ryu/ryu/app/simple_switch.py''' 
+      3.    Now ping again from s1 to VNF1, the ping should work. 
+    
+====  2.2 NFV OVS controller ==== 
+
+Next we are going to run a different Ryu controller that will install !OpenFlow rules to support NFV load balancing as well as handling intrusion. With this controller, the traffic shall go from a source to destination, and duplicate packets are sent to one of the IDS nodes (VNF1 or VNF2) for Intrusion detection. The picture below shows a red line representing traffic going from source1 to destination, and the green line represents the duplicate traffic that is sent to VNF1 for intrusion detection.
+
+{{{
+#!html
+<img src="http://csr.bu.edu/rina/grw-bu2016/tutorial_files/image040.gif" hspace=100>
+ }}}
+
+=== 3.     Execute Experiments: ===
+
+3.1. First we need to download the source code and configuration files for the NFV  Ryu controller onto the controller VM. In the window of controller, run the following:
+          - '''cd ~''' 
+          - '''wget !http://csr.bu.edu/rina/grw-bu2016/nfv_ryu/setup_nfv_ryu_controller.sh'''
+          -  '''chmod 755 setup_nfv_ryu_controller.sh '''
+          -  '''./setup_nfv_ryu_controller.sh'''
+
+3.2. Now you should have all files needed for the NFV Ryu controller. Open ''nfv.config'' file to configure the system parameters. You can use any editor to edit the file, and we l use nano here as an example.
+         -  '''nano ~/ryu/ryu/app/nfv.config'''
+
+3.3. You will see the details of this configuration file as follows.  Change the values of ''vnf1_interface'' and ''vnf2_interface'' to the values that you noted down in ''Section 3.3.1'' in the '''[wiki:GENIExperimenter/Tutorials/NFV/DesignSetup Design/Setup]''' section of this tutorial. These values will tell the controller which interfaces are connected to VNF1 and VNF2.
+
+{{{
+#!html
+<img src="http://csr.bu.edu/rina/grw-bu2016/nfv_ryu/pics/configPic.png" hspace=100>
+ }}}
+
+'''[wiki:GENIExperimenter/Tutorials/NFV/Ryu/LoadBalanceRRwithRyu Experiment 1:  Load Balancing using Round Robin Control with Ryu Controller]'''[[BR]]
+'''[wiki:GENIExperimenter/Tutorials/NFV/Ryu/LoadBalancePIwithRyu Experiment 2:  Load Balancing using Proportional Integral (PI) Control with Ryu Controller]'''[[BR]]
+'''[wiki:GENIExperimenter/Tutorials/NFV/Ryu/HandlingIntrusionwithRyu Experiment 3: Handing Intrusion with Ryu Controller]'''[[BR]]
+
+----
+== Part III: Finish ==
+
+=== Tear down Experiment and Release Resources: ===
+
+After you are done with all experiments, close all your open windows and release your resources. In the GENI Portal, select the slice and click on the `Delete` button. Now you can start designing and running your own experiments!
+
+----
+----
+'''Author: Yuefeng Wang'''
+
+'''Supervised by: Ibrahim Matta '''
+
+'''Boston University'''
+