Changes between Version 96 and Version 97 of Documentation/CGettingStarted


Ignore:
Timestamp:
May 6, 2016, 9:38:26 PM (8 years ago)
Author:
jkol
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/CGettingStarted

    v96 v97  
    99== Six Steps ==
    1010A typical experiment requires the following six steps:
    11  1. [[CollapsibleStart(Create resource reservation)]][[Include(Documentation/Short/CreateRes)]][[CollapsibleEnd]]
    12 The user needs a set of nodes/resources from a domain to run the experiment on.For the rest of this tutorial we will assume that the the reserveation was made for sb1 domain.
    13  2.  [[CollapsibleStart(Login into reserved domain: "ssh username@sb1.orbit-lab.org")]][[Include(Documentation/Short/Login)]][[CollapsibleEnd]]
    14 After you receive the confirmation email, you can access the reserved domain by ssh to the corresponding domain console.
    15  3.  [[CollapsibleStart(Load an image on the nodes: "omf load -i baseline.ndz -t all")]] [[Include(Documentation/Short/LoadImage)]][[CollapsibleEnd]]
    16 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.
    17  4. [[CollapsibleStart(Turn the nodes on: "omf tell -a on -t all")]][[Include(Documentation/Short/TellOn)]][[CollapsibleEnd]]
    18 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
    19  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]]
    20 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 that the domain is: '''sb1.orbit-lab.org''' and the two nodes are '''node1-1.sb1.orbit-lab.org''' and '''node1-2.sb1.orbit-lab.org'''.
     11
     12  [[CollapsibleStart(1. Create a resource reservation)]]
     13  The user needs a set of nodes/resources from a domain to run the experiment on.
     14  [[Include(Documentation/Short/CreateRes)]]
     15  ''For the rest of this tutorial we will assume that the the reservation was made for the sb1 domain.''
     16  [[CollapsibleEnd]]
     17  [[CollapsibleStart(2. Login into reserved domain)]]
     18  "ssh username@sb1.orbit-lab.org"
     19  After you receive the confirmation email, you can access the reserved domain by SSH'ing to the corresponding domain console.
     20  [[Include(Documentation/Short/Login)]]
     21  [[CollapsibleEnd]]
     22  [[CollapsibleStart(3. Load an image on the nodes)]]
     23  "omf load -i baseline.ndz -t all"
     24  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.
     25  [[Include(Documentation/Short/LoadImage)]]
     26  [[CollapsibleEnd]]
     27  [[CollapsibleStart(4. Turn the nodes on)]]
     28  "omf tell -a on -t all"
     29  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.
     30  [[Include(Documentation/Short/TellOn)]]
     31  [[CollapsibleEnd]]
     32  [[CollapsibleStart(5. Execute the experiment)]]
     33  "omf exec test:exp:tutorial:hello-world-wireless -- --res1 node1-1.sb1.orbit-lab.org --res2 node1-2.sb1.orbit-lab.org"
     34  [[Include(Software/cOMF/aExec)]]
     35  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 that the domain is: '''sb1.orbit-lab.org''' and the two nodes are '''node1-1.sb1.orbit-lab.org''' and '''node1-2.sb1.orbit-lab.org'''.
    2136{{{
    2237username@console.sb1:~$ omf exec test:exp:tutorial:hello-world-wireless -- --res1 node1-1.sb1.orbit-lab.org --res2 node1-2.sb1.orbit-lab.org
     
    5267username@console.sb1:~$
    5368}}}
    54  6. You can view the results by pointing a webrowser to: a [http://console.sb1.orbit-lab.org:5054/result/dumpDatabase?expID=default_slice-2013-01-29t01.03.19-05.00 url] of this form:
     69  [[CollapsibleEnd]]
     70  [[CollapsibleStart(6. View experiment results)]]
     71  You can view the results by pointing a webrowser to: a [http://console.sb1.orbit-lab.org:5054/result/dumpDatabase?expID=default_slice-2013-01-29t01.03.19-05.00 url] of this form:
    5572{{{
    56 http://console.sb1.orbit-lab.org:5054/result/dumpDatabase?expID=EXPERIMENT_ID.
     73  http://console.sb1.orbit-lab.org:5054/result/dumpDatabase?expID=EXPERIMENT_ID.
    5774}}}
    58  The exiprment ID is an auto-generated string that is reported during the run of the experiment. In this case it was
     75  The exiprment ID is an auto-generated string that is reported during the run of the experiment. In this case it was
    5976{{{
    60 INFO NodeHandler: Experiment ID: default_slice-2013-01-29t01.03.19-05.00
     77  INFO NodeHandler: Experiment ID: default_slice-2013-01-29t01.03.19-05.00
    6178}}}
    62  It should look something like:[[BR]]
    63  [[Image(Result.png,500px)]][[BR]]
    64  More information on result analysis can be found [wiki:/Tutorials/a0Basic/Tutorial3 here]
    65  7. (optionally) Save the image [[CollapsibleStart(Save Image with omf: "omf save -n node1-1.sb1.orbit-lab.org")]] [[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!
     79  It should look something like:[[BR]]
     80  [[Image(Result.png,500px)]][[BR]]
     81  More information on result analysis can be found [wiki:/Tutorials/a0Basic/Tutorial3 here]
     82  [[CollapsibleEnd]]
     83  [[CollapsibleStart(7. (optionally) Save the node image)]]
     84  Save Image with omf: "omf save -n node1-1.sb1.orbit-lab.org" [[Include(Documentation/Short/SaveImage)]]
     85  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!
     86  [[CollapsibleEnd]]
    6687
    6788== Where to go from here ==
    6889
    69 If you are still unsure what Orbit is, please read the [wiki:FAQ FAQ] and check other [wiki:Tutorials tutorials].
     90  If you are still unsure what Orbit is, please read the [wiki:FAQ FAQ] and check other [wiki:Tutorials tutorials].