[wiki:WikiStart Orbit] > GettingStarted = How to get started = First, you will need an ORBIT account. Please check the [wiki:Documentation/UsagePolicy usage policy] if you are eligible. Typically, in order to get an account,one would have to [http://www.orbit-lab.org/userManagement/register register for an account] and get it approved by the PI in charge of the project/institution they wish to be part off. If particular institution is not available, the appropriate PI can [http://www.orbit-lab.org/userManagement/orgReg register] for an institutional account. A typical experiment requires the following five steps: 1. Create reservation: [[BR]] Before you can access the testbed,you need to [http://www.orbit-lab.org/scheduler/ make a reservation] and get it approved by the [wiki:Documentation/Scheduler 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 [wiki:/Tutorials/HelloWorld Hello World] experiment. For the rest of this tutorial we will assume that user reserved sb1. 2. Access the domain: [[CollapsibleStart(Login into reserved domain)]][[Include(Documentation/Short/Login)]][[CollapsibleEnd]] After you receive the confirmation email, you can access the reserved domain by ssh to the corresponding domain console. {{{ ssh username@sb1.orbit-lab.org }}} 3. Load the images: [[CollapsibleStart(Load an image on the nodes)]] [[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. If the imaging process does not does not finish within the default timeout period, that period can be increase by using the '''-o''' flag (e.g. -o 1600). At this point the nodes disks are imaged with the ''baseline'' image and need to be turned back on before proceeding. {{{ username@sb1.orbit-lab.org:~$ omf tell -a offh -t all ... username@sb1.orbit-lab.org:~$ omf load -i baseline.ndz -t all ... username@console.sb1:~$ omf tell -a on -t all }}} Give the nodes a couple of minutes to turn on / boot, then check their status with omf stat 4. Run the experiment: [[CollapsibleStart(Execute experiment with omf)]][[Include(Software/cOMF/aExec)]][[CollapsibleEnd]] Execute "Hello World" experiment. This is a simple wireless experiment that establishes !WiFi the link between two nodes and transfer data for 60 seconds. {{{ username@console.sb1:~$ omf exec test:exp:tutorial:hello-world-wireless INFO NodeHandler: OMF Experiment Controller 5.4 (git c005675) INFO NodeHandler: Slice ID: default_slice (default) INFO NodeHandler: Experiment ID: default_slice-2013-01-29t01.03.19-05.00 INFO NodeHandler: Message authentication is disabled INFO Experiment: load system:exp:stdlib INFO property.resetDelay: resetDelay = 230 (Fixnum) INFO property.resetTries: resetTries = 1 (Fixnum) INFO Experiment: load system:exp:eventlib INFO Experiment: load test:exp:tutorial:hello-world-wireless INFO property.duration: duration = 60 (Fixnum) INFO property.graph: graph = false (FalseClass) INFO Topology: Loading topology 'system:topo:imaged'. INFO Topology: Loading topology '/tmp/pxe_slice-2013-01-26t22.21.22-05.00-topo-success'. INFO ALL_UP_AND_INSTALLED: Event triggered. Starting the associated tasks. INFO exp: This is my first OMF experiment INFO exp: Request from Experiment Script: Wait for 15s.... INFO node1-1.sb1.orbit-lab.org: Device 'net/w0' reported Not-Associated INFO node1-2.sb1.orbit-lab.org: Device 'net/w0' reported Not-Associated INFO node1-1.sb1.orbit-lab.org: Device 'net/w0' reported 12:B2:78:8E:8D:4F INFO node1-2.sb1.orbit-lab.org: Device 'net/w0' reported 12:B2:78:8E:8D:4F INFO exp: All my Applications are started now... INFO exp: Request from Experiment Script: Wait for 60s.... INFO exp: All my Applications are stopped now. INFO EXPERIMENT_DONE: Event triggered. Starting the associated tasks. INFO NodeHandler: INFO NodeHandler: Shutting down experiment, please wait... INFO NodeHandler: INFO run: Experiment default_slice-2013-01-29t01.03.19-05.00 finished after 1:23 username@console.sb1:~$ }}} 5. Analyze the results == Where to go from here == If you are still unsure what Orbit is, please read the [wiki:FAQ FAQ] and check other [wiki:Tutorials tutorials].