Changes between Version 85 and Version 86 of Documentation/CGettingStarted


Ignore:
Timestamp:
Sep 30, 2014, 4:13:13 AM (10 years ago)
Author:
seskar
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/CGettingStarted

    v85 v86  
    66
    77== Six Steps ==
    8 A typical experiment requires the following five steps:
     8A typical experiment requires the following six steps:
    99 1. Create reservation: [[BR]] Before you can access the testbed,you need to [https://www.orbit-lab.org/loginService/ControlPanel make a reservation] and get it approved by the  [wiki:Documentation/bAccountManagement/aScheduler reservation service]. First time users are '''highly''' encouraged to reserve time on a sandbox instead of the main grid, and start with this built-in "Hello World" experiment. For the rest of this tutorial we will assume that user reserved sb1 domain.
    10  1.  [[CollapsibleStart(Login into reserved domain: ssh username@sb1.orbit-lab.org)]][[Include(Documentation/Short/Login)]][[CollapsibleEnd]] - after you receive the confirmation email, you can access the reserved domain by ssh to the corresponding domain console.
    11  1.  [[CollapsibleStart(Load an image on the nodes: omf load -i baseline.ndz -t all)]] [[Include(Documentation/Short/LoadImage)]][[CollapsibleEnd]] - prior to executing the "Hello World" experiment, users need to install an image on the hard disks of the nodes. For this tutorial we will use '''baseline.ndz'''. This image is built on top of '''Ubuntu 12.04''', and is pre-configured with the proper modules and start up scripts to take advantage of the rest of the Orbit [wiki:/Software software] / [wiki:/Hardware hardware]. The imaging process will turn the nodes back off after completing imaging.
    12   4. [[CollapsibleStart(Turn the nodes on: omf tell -a on -t all)]][[Include(Documentation/Short/LoadImage)]][[CollapsibleEnd]] - at this point the nodes disks are imaged with the ''baseline'' image and need to be turned back on before proceeding. Give the nodes a couple of minutes to turn on / boot, then check their status with omf stat
    13  4. [[CollapsibleStart(Execute experiment with omf: 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]] Execute "Hello World" experiment. This is a simple wireless experiment that establishes the !WiFi link between two nodes and transfers data for 60 seconds. Be sure to specify the fully qualified domain names (FQDNs) of the two nodes involved.  For the output below, it is assumed to be "sb1.orbit-lab.org".
     10 2.  [[CollapsibleStart(Login into reserved domain: ssh username@sb1.orbit-lab.org)]][[Include(Documentation/Short/Login)]][[CollapsibleEnd]]
     11After you receive the confirmation email, you can access the reserved domain by ssh to the corresponding domain console.
     12 3.  [[CollapsibleStart(Load an image on the nodes: omf load -i baseline.ndz -t all)]] [[Include(Documentation/Short/LoadImage)]][[CollapsibleEnd]]
     13Prior to executing the "Hello World" experiment, users need to install an image on the hard disks of the nodes. For this tutorial we will use '''baseline.ndz'''. This image is built on top of '''Ubuntu 12.04''', and is pre-configured with the proper modules and start up scripts to take advantage of the rest of the Orbit [wiki:/Software software] / [wiki:/Hardware hardware]. The imaging process will turn the nodes back off after completing imaging.
     14 4. [[CollapsibleStart(Turn the nodes on: omf tell -a on -t all)]][[Include(Documentation/Short/LoadImage)]][[CollapsibleEnd]]
     15At this point the nodes disks are imaged with the ''baseline'' image and need to be turned back on before proceeding. Give the nodes a couple of minutes to turn on / boot, then check their status with omf stat
     16 5. [[CollapsibleStart(Execute experiment with omf: 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]]
     17Execute "Hello World" experiment. This is a simple wireless experiment that establishes the !WiFi link between two nodes and transfers data for 60 seconds. Be sure to specify the fully qualified domain names (FQDNs) of the two nodes involved.  For the output below, it is assumed to be "sb1.orbit-lab.org".
    1418{{{
    1519username@console.sb1:~$ omf exec test:exp:tutorial:hello-world-wireless -- --res1 node1-1.sb1.orbit-lab.org --res2 node1-2.sb1.orbit-lab.org
     
    4549username@console.sb1:~$
    4650}}}
    47  5. Analyze the results
     51 6. Analyze the results
    4852Use various tools to analyze the results.
    4953
    50  6. (optionally) Save the image [[CollapsibleStart(Save Image with omf)]] [[Include(Documentation/Short/SaveImage)]][[CollapsibleEnd]] If you modified the basiline image and/or added software to it, you want to save it into repository before the end of your time slot!
     54 7. (optionally) Save the image [[CollapsibleStart(Save Image with omf)]] [[Include(Documentation/Short/SaveImage)]][[CollapsibleEnd]] If you modified the basiline image and/or added software to it, you want to save it into repository before the end of your time slot!
    5155
    5256== Where to go from here ==