Changes between Version 59 and Version 60 of Documentation/CGettingStarted


Ignore:
Timestamp:
01/17/13 19:30:09 (7 years ago)
Author:
ssugrim
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/CGettingStarted

    v59 v60  
    77A typical experiment requires the following three steps:
    88
    9  * [wiki:Documentation/Scheduling Reservation]
     9 * [#Reservations Reservation]
    1010 * [#LoadImage Loading an Image]
    1111 * [wiki:Tutorial/RunningExpirment Running the experiment]
    1212 * [wiki:Tutorial/AnalyzeResults Analyzing the results]
    1313 * [#NextStep Next steps]
     14
     15== Reservations == #Reservations
     16
     17As this is a wireless testbed, it is difficult to run multiple experiments without interference. Therefore, we currently only support one experiment at a time on the individual grid. In Orbit speak, a grid is a set of nodes together with the controlling console which can be used to run experiments. In the present setup, the testbed consists of a single large grid (main grid) with 400 nodes and an array of sandboxes i.e. "grids" with only 2 nodes and a console, which are development and test environments intended to reduce the time experimenters need on the main grid. Ideally, experimenters develop their software (application programs, routing protocols, measurement instrumentation, etc.) on off-site machines and then use the sandboxes for integration with the orbit environment and orbit software infrastructure. Once the experiment runs successfully in the sandbox environment, it can be moved to the main grid.
     18
     19||[[Image(Schedule-howto3.jpg, width=500)]]||
     20||Figure 1: Scheduler web page||
     21
     22Reservations for Orbit resources (the main grid or any of the sandboxes) can be made on the [https://www.orbit-lab.org/schedule/ ORBIT Schedule page]. The scheduler main screen is illustrated in Figure 1.
     23
     24To reserve a resource, first navigate to the table for the day you wish to make the reservation on (please note that you can advance the calendar by using navigation links at the bottom of the page; also you cannot reserve a resource for a date/time that has passed or the one for which you don't have permission). Once you have located the table for the requested day, click on the time slot you want to use as a start time of your resource reservation. This will open the form showing the detail of the reservation. Currently slot duration is limited to 2 hours per request.
     25
     26[[Image(Schedule-howto4.jpg, border:solid 2px black)]]
     27[[Image(Schedule-howto5.jpg, title="Newly crated reservation", align=right, width=250, border:solid 2px black)]]
     28
     29After saving the reservation, the pop-up windows is closed and main scheduler table is updated with the newly created reservation slot in yellow color indicating that it is in the "pending approval" state. Also, the email notification  on the reservation is sent to your registered email address. 
     30
     31Reservations slots are approved by the scheduling service based on the [wiki:Documentation/Scheduling#ReservationApprovalPolicies two stage approval policy]. Once it has been approved, the color for that slot will be changed to dark blue and approval email notification message will be sent to the requester and requester will be able to access the console of the resource whose reservation was just approved.
     32
     33=== Conflicts ===
     34
     35It is possible to ask for a particular slot even if other user already made a reservation for it. The procedure is the same as for requesting an empty slot except that the resulting color changes to red once there are multiple simultaneous (conflicting) reservations as shown in Figure 2.
     36
     37||[[Image(Schedule-HowTo6.jpg)]]||
     38||Figure 2: Scheduling Conflicts||
     39
     40=== Reservation Approval Policies ===
     41
     42Reservation approval process is based on a two stage algorithm. In the first (pre-approval) stage, scheduling requests received before noon will be pre-approved for the following day. For example, if it is Tuesday morning before noon, and you ask for 4 to 6 in the evening Wednesday, you will know for sure whether you have this time by 2 in the afternoon on Tuesday. Users are limited to two hours a day of pre-approved time on the main grid.
     43
     44For the reservations that are made less than twelve hours in advance or for ones that are more than 2 hours a day, the slots will be automatically approved at the beginning of the slot (second or just-in-time approval stage).
     45
     46=== Conflict Resolution ===
     47
     48Conflicts will be resolved based on how much time you've already used over the last two weeks. Those who have used less time on the main grid in the last two weeks will be more likely to have their requests approved for the conflicting slots.
     49
     50Due to complexity of the conflict resolution algorithm, please refrain from conflicting on slots that are less that 2 hours in the future since just-in-time approval process will not try to resolve conflicts.
    1451
    1552== Loading an Image == #LoadImage
     
    157194    Give the nodes a couple of minutes to turn on / boot, then check their status with omf stat.
    158195
    159 = Where to go from here = #NextStep
     196== Where to go from here == #NextStep
    160197
    161198If you are still unsure what Orbit is, please read the [wiki:FAQ FAQ] and the [wiki:Tutorial Tutorial], otherwise go ahead and [http://www.orbit-lab.org/userManagement/register register].