Changes between Version 35 and Version 36 of Tutorials/oMF/tut1


Ignore:
Timestamp:
Dec 1, 2016, 12:55:18 PM (8 years ago)
Author:
seskar
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Tutorials/oMF/tut1

    v35 v36  
    33[[TOC(Tutorials/oMF*, depth=2)]]
    44
    5 
    6 === !Design/Setup ===
    7 
    8 ==== Objective ====
     5=== Objective ===
    96
    107In 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.
    118
    12 ==== Pre-requisites ====
    13 
    14  * Experimenters are expected to have basic networking knowledge and familiarity with Linux OS and some of its tools (command line tools, ssh, etc.).
    15  * An ORBIT user account.
    16  * Some familiarity with the !MobilityFirst terminology.
     9[[Include(Documentation/Short/Prereq)]]
     10
     11In addition to basic ORBIT prerequisites, the experimenters are expected to have basic networking knowledge and basic familiarity with the !MobilityFirst terminology.
    1712
    1813==== Topology ====
    1914
    20 In 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:
    21 
    22 [[Image(Tutorials/oMF:MFTurorialNetwork.png)]]
     15In this exercise we will use a simple linear topology consisting of two !MobilityFirst routers (MFR) that interconnecting two hosts: Host1 will initiate a 'ping' communication and Host2 will respond to the ping request.
     16
     17[[Image(MFTutorialNetwork.png)]]
     18
     19The two hosts will use !WiFi to connect to the edge routers (i.e. they are considered to be "mobile").
     20
     21This tutorial is assuming use of grid resources which is not a strict a requirement i.e. for the successful execution of this experiment any sandbox with at least 4 nodes could be used (i.e. sb4, sb9, etc.)
     22Note: This tutorial won't work on SB9 without modification since SB9 nodes don't have WiFi devices.
    2323
    2424==== !MobilityFirst ORBIT Image ====
     
    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.
    2727
    28 A typical Orbit experiment requires the following six steps:
    29 
    30  1. [[CollapsibleStart(Create resource reservation)]][[Include(Documentation/Short/CreateRes)]][[CollapsibleEnd]]
    31 
    32  2. [[CollapsibleStart(Login into reserved domain: "ssh username@sb1.orbit-lab.org")]][[Include(Documentation/Short/Login)]][[CollapsibleEnd]]
    33 
    34  3. [[CollapsibleStart(Load an image on the nodes: "omf load -i baseline.ndz -t all")]] [[Include(Documentation/Short/LoadImage)]][[CollapsibleEnd]]
    35 
    36  4. [[CollapsibleStart(Turn the nodes on: "omf tell -a on -t all")]][[Include(Documentation/Short/TellOn)]][[CollapsibleEnd]]
    37 
    38  5. [[CollapsibleStart(Execute the experiment: "omf exec test:exp:tutorial:hello-world-wireless -- --res1 node1-1.sb1.orbit-lab.org --res2 node1-2.sb1.orbit-lab.org")]][[Include(Software/cOMF/aExec)]][[CollapsibleEnd]]
    39 
    40  6. Analyze the results
    41 
    42 While, most of the experiments follow the presented structure, for this specific tutorial some simplifications have been applied.
    43 
    44 From now on, the following assumptions are considered:
    45 
    46  * You will be working with resources belonging to the Orbid grid.
    47  * You have been assigned a group number, username and password.
    48 
    49 While for this experiment we are using the grid, it is not a strict a requirement and for the successful execution of the experiment any sandbox with at least 4 nodes could be employed (i.e. sb4, sb9, etc.)
    50 Note: This tutorial won't work on SB9 because SB9 currently doesn't have WiFi.
    51 
    52 First of all, log in into the grid console using SSH:
    53 
    54 {{{
    55 #!sh
    56 
    57 ssh username@console.grid.orbit-lab.org
    58 }}}
    59 
    60 For simplicity, open 3 different consoles on your laptop and access the grid's console with all of them; you will need them in the continuation of the exercise.
    61 From the console we will start loading the !Mobilityfirst image into the four nodes that have been assigned to you:
    62 
     28==== Experiment Execution ====
     29
     30As is the case with every ORBIT based experiment, it starts with [wiki:Tutorials/a0Basic/Tutorial1 the first four of the six step experiment lifecycle]. Once your grid reservation is approved, log in into the grid console using SSH:
     31{{{
     32#!sh
     33
     34ssh your_user_username@console.grid.orbit-lab.org
     35}}}
     36
     37For simplicity, open 3 simultaneous sessions on your local machine and access the grid's console with all of them; you will need them in the continuation of the exercise.
     38
     39In one of the consoles we will start loading the !Mobilityfirst image into the four nodes that have been assigned to you:
    6340{{{
    6441#!sh