|Version 43 (modified by 9 years ago) ( diff ),|
How to get started
A typical experiment requires the following three steps:
Running the Experiment
During your approved time slot, you will be able to ssh into the console of the respective grid. A console is a dedicated machine that allows access to all resources on that grid.
During your approved time slot, you can then log into the console corresponding to the following table using SSH:
|Main grid (400 nodes)||console.grid.orbit-lab.org|
|Sandbox 1 (2 nodes)||console.sb1.orbit-lab.org|
|Sandbox 2 (2 nodes)||console.sb2.orbit-lab.org|
|Sandbox 5 (2 nodes)||console.sb5.orbit-lab.org|
|Sandbox 6 (2 nodes)||console.sb6.orbit-lab.org|
|Sandbox 7 (2 nodes)||console.sb7.orbit-lab.org|
|Sandbox 8 (2 nodes)||console.sb8.orbit-lab.org|
For e.g to access the sandbox2,
When you have successfully logged in, you can start an experiment using the nodehandler. First time users are highly encouraged to reserve time on a sandbox instead of the main grid, and start with the built-in Hello World experiment.
- Before we begin using the nodes, it's a good idea to check their status first. This is done with the omf stat command.
email@example.com:~$ omf statThis will typically produce a result like: The node can be in 1 of 3 states:
POWEROFF Node is Available for use but turned off POWERON Node is Available and is on NODE NOT AVAILABLE Node is not Available for use
- NOTE: It is recommended that the node be in the POWEROFF state prior to any imaging process. If the node is in the POWERON state you can use the omf tell command
to get the node into the off state.
firstname.lastname@example.org:~$ omf tell offh allIf the node is in the NODE NOT AVAILABLE state, you may need to wait for it to recover the POWEROFF state (it some times requires a few moments for the service to sync up). If the node never comes out of the NODE NOT AVAILABLE state please contact an administrator.
- Prior to the experiment, users need to install the baseline image on the hard disks of the nodes. This is done with the omf load command
email@example.com:~$ omf load Topology ImageNameWhere Topology specifies the set of nodes you wish to image, and ImageName is the name of the image you with to load. The most common sandbox starting image command would look like
firstname.lastname@example.org:~$ omf load all baseline.ndz
which will load all the nodes of sandbox 2 (toatling 2) with the baseline image.
After the imaging process is complete as shown in the figure below, users can now run the Helloworld experiment.
The experiment can be started with:
user#> nodehandler -t
- This experiment will send UDP datagrams of 1024 bytes from node 1-1 to node 1-2 at 300 kbps CBR traffic.
- Both, sender and receiver, report measurements to a database, using our OML measurement framework.
- As shown below, the experiment controller will power on the nodes involved in the experiment and will issue experiment commands to each node.
- Each experiment has a unique experiment ID as shown in the figure, that can be used later to view the results from the database
Alternatively, a specific script can be run as follows:
The experiment can be started with:
user#> nodehandler <full-path/script-name>
For e.g., if my script is called orbit-test.rb and it resides in /home/joenull/Ruby-Scripts/ (ORBIT home directory), I would execute it as follows:
user#>pwd /home/joenull user#>nodehandler ~/Ruby-Scripts/orbit-test
Note that I leave out the ".rb" at the end. This will execute the scripts and turn the nodes OFF at the end of the experiment. If you want to leave them ON after the experiment, use the "-k" flag. For e.g.
user#>pwd /home/joenull user#>nodehandler -k ~/Ruby-Scripts/orbit-test
The experimenter can also move to where the script resides and execute it (without giving the full path) since nodehandler will look for the script in the current directory.
More information on writing experiment scripts can be found in the Tutorial.
Orbit provides a sophisticated framework to efficiently collect measurements at runtime into a database. This database is accessible to the experimenter during the experiment from the console. At the end of an experiment, the database is copied to an external machine and is accessible without a reservation. More information can be found here.
Where to go from here
- Schedule-howto3.jpg (128.8 KB ) - added by 7 years ago.
- Schedule-howto4.jpg (56.7 KB ) - added by 7 years ago.
- Schedule-howto5.jpg (49.3 KB ) - added by 7 years ago.
- Schedule-HowTo6.jpg (66.6 KB ) - added by 7 years ago.
) - added by 5 years ago.
Demo result pae
Download all attachments as: .zip