Changes between Version 33 and Version 34 of Tutorials/oMF/tut1


Ignore:
Timestamp:
May 5, 2015, 2:29:32 AM (10 years ago)
Author:
seskar
Comment:

—

Legend:

Unmodified
Added
Removed
Modified

  • Tutorials/oMF/tut1

    v33 v34  
    1 = Exercise 1: Simple !MobilityFirst Network Deployment and Test =
     1== Exercise 1: Simple !MobilityFirst Network Deployment and Test ==
    22
    33[[TOC(Tutorials/oMF*, depth=2)]]
    44
    55
    6 == !Design/Setup ==
    7 
    8 === Objective ===
     6=== !Design/Setup ===
     7
     8==== Objective ====
    99
    1010In this exercise we will establish a simple topology consisting of !MobilityFirst routers, hosts and applications, deploy the software components onto physical nodes, and run an end-to-end 'ping' application. At the end of the exercise, you should expect to acquire a general knowledge of the !MobilityFirst software components and how to deploy and configure them using the Orbit testbed.
    1111
    12 === Pre-requisites ===
     12==== Pre-requisites ====
    1313
    1414 * Experimenters are expected to have basic networking knowledge and familiarity with Linux OS and some of its tools (command line tools, ssh, etc.).
    … …  
    1616 * Some familiarity with the !MobilityFirst terminology.
    1717
    18 === Topology ===
     18==== Topology ====
    1919
    2020In this exercise we will use a simple linear topology consisting of two !MobilityFirst routers (MFR) that interconnect two hosts: Host1 will initiate a 'ping' communication and Host2 will respond to the ping request:
    … …  
    2222[[Image(Tutorials/oMF:MFTurorialNetwork.png)]]
    2323
    24 === !MobilityFirst ORBIT Image ===
     24==== !MobilityFirst ORBIT Image ====
    2525
    2626The complete set of components from the latest release of the !MobilityFirst software is available as a compressed image within the ORBIT testbed for imaging nodes using the 'OMF' tool. The current pre-prepared image is built over Ubuntu 12.04 LTS distribution and will be moved to newer distributions as they become available and we have had a chance to test compatibility.
    … …  
    8989your nodes have been imaged correctly.
    9090
    91 === Deploy Network ===
     91==== Deploy Network ====
    9292
    9393Software and experiment control in the ORBIT testbed can be automated greatly using the OMF framework. An OMF control script is written in Ruby and allows the experimenter to specify the set of nodes, their network configuration, to specify software components and arguments, and to control their execution on one or more nodes. We will use an OMF script to bring up 4 ORBIT nodes to host our topology, with the corresponding software components.
    … …  
    9595We will first introduce the main details of the scripts that will be run and then we will step to the execution process itself.
    9696
    97 ==== Software Component Specification ====
     97===== Software Component Specification =====
    9898
    9999The following snippet shows the specification of the !MobilityFirst components along with the required arguments. A typical application will have at least a brief description, a path for the associated binary to execute and a list of properties that correspond to the parameters  that will be passed once starting the executable.
    … …  
    150150 * Most of the client settings are located in a configuration file pre-loaded on the ORBIT image in the folder ''/usr/local/src/mobilityfirst/eval/orbit/conf/''.
    151151
    152 ==== Setting up the Software Node Groups ====
     152===== Setting up the Software Node Groups =====
    153153
    154154The following snippet shows how the node groups for the routers are setup in the OMF control scripts. Node groups allow experimenters to use single statements to set configuration (e.g. network interfaces) and execute commands across all nodes belonging to the group.
    … …  
    238238
    239239
    240 == Execute ==
    241 
    242 ==== Starting the !MobilityFirst Components ====
     240=== Execute ===
     241
     242===== Starting the !MobilityFirst Components =====
    243243
    244244The final part of the experiment script is dedicated to the execution events and commands. The following snippet shows the starting of the router software, the gnrs server and the client network protocol stack:
    … …  
    288288
    289289
    290 ==== Executing the script ====
     290===== Executing the script =====
    291291
    292292First of all you will first need to turn your assigned nodes on:
    … …  
    365365  * The GUIDs assigned to the nodes can be seen. For this particular snippet, the routers (nodes1-1 and 1-2 on the grid) are assigned GUID 1 and 2, and the hosts (nodes2-1 and 2-2 on the grid) have GUID 101 and 102. Since we have a simple topology in this experiment, only a single instance of GNRS server is running, which as shown above is hosted by router with GUID 1.
    366366
    367 === Test The Network ===
     367==== Test The Network ====
    368368
    369369Before proceeding to the next step, make sure your OMF script has reached the line:
    … …  
    421421
    422422
    423 == Finish ==
     423=== Finish ===
    424424
    425425Once the application has successfully completed its task, follow these steps to complete the experiments:
    … …  
    428428This will stop all the applications and will conclude the experiment.
    429429
    430 === References ===
     430==== References ====
    431431
    432432For more information regarding the !MobilityFirst project, visit the project page: http://mobilityfirst.winlab.rutgers.edu/