Changes between Version 1 and Version 2 of GENIExperimenter/Tutorials/StitchingTutorial/DesignSetupWithJacks

02/05/15 11:15:49 (9 years ago)



  • GENIExperimenter/Tutorials/StitchingTutorial/DesignSetupWithJacks

    v1 v2  
    1 Hello
     1= [ GENI Inter-Aggregate Stitching Tutorial] =
     5<div style="text-align:center; width:495px; margin-left:auto; margin-right:auto;">
     6<img id="Image-Maps_5201305222028436" src="" usemap="#Image-Maps_5201305222028436" border="0" width="495" height="138" alt="" />
     7<map id="_Image-Maps_5201305222028436" name="Image-Maps_5201305222028436">
     8<area shape="rect" coords="18,18,135,110" href="" alt="" title=""    />
     9<area shape="rect" coords="180,18,297,111" href="" alt="" title=""    />
     10<area shape="rect" coords="344,17,460,110" href="" alt="" title=""    />
     11<area shape="rect" coords="493,136,495,138" href="" alt="Image Map" title="Image Map" />
     13<!-- Image map text links - End - -->
     18= Step 1: Download and Import Initial Resource Request RSpec =
     20For this tutorial we are going to use the Flack tool as an rspec editor, but we are going to do the actual reservation using Omni, a command line tool.
     22This tutorial starts with an existing RSpec which includes 3 nodes in a linear topology. The resources are un-bound, which means the resources are not affiliated with any rack aggregate.
     26To get started download the initial RSpec file and import it into Flack to make modifications as follows:
     28'''1.''' Login to the GENI Portal at
     30'''2.''' Go to the [ "Projects"] panel and click on the '' "Create Slice" '' button for the tutorial project. (If you are running this tutorial on your own, you may use any existing project you belong to.)  On the "Create New Slice"  page enter a slice name and click on "Create slice" button. For the purpose of this tutorial we will assume the slice is named ''!MySlice'', but you should use a unique name because each slice name must be unique within a project.
     32'''3.''' On the slice page select the ''"Launch Flack"'' button. (You must wait for all aggregates to show up in the !MySlice panel before you can proceed.)
     34'''4.''' On the Flack slice canvas, select the pull-down named ''"Import"'' and choose the ''"Import from the web"'' option. Paste this URL and click ''"Ok"''.
     36     [[Image(GENIExperimenter/Graphics:import-from-web.jpg)]]
     39'''5.''' You will see a pop-up that states that no manager is associated with the resource; click ''"OK"'' and another pop-up will have you select an aggregate manager, select one of the two aggregate managers assigned to you and click the ''"Accept"'' button.  (If you are running this tutorial on your own, you may use any aggregate found on the [ GENI Network Stitching Sites] page.
     41     [[Image(GENIExperimenter/Graphics:import-add-aggr.jpg)]]
     44= Step 2: Modify RSpec to include 2 Aggregates with 1 stitched link =
     46Now that you have imported the RSpec, we will modify it to include a stitched link. Modifications in this section will result in the following topology:
     50To get to the above topology, we must make changes to the resources imported into Flack.  We will now modify ''"right-client"'' to become part of a different rack aggregate and then modify its link to be a stitched link.
     52'''6.''' Click on the ''"right-client"'' VM information button [[Image(GENIExperimenter/Graphics:info.jpg)]].
     54'''7.''' In the ''"right-client"''  details panel look for the ''"Manager"'' pull-down. Modify the aggregate to be the second aggregate manager that was assigned to you at the beginning of the tutorial; do not use the aggregate used earlier.  Click on the ''"Apply"'' button.  (If you are running this tutorial on your own, you may use any other site aggregate found on the [ GENI Network Stitching Sites] page.)
     56'''8.''' You will now see that the link from the ''"server"'' VM to ''"right-client"'' VM is now a gre-tunnel link.  Select the gre-tunnel link information button [[Image(GENIExperimenter/Graphics:info.jpg)]] to modify the link type to ''"stitched"'' and click ''"Apply"'' button.
     58     [[Image(GENIExperimenter/Graphics:gre-to-stitched.jpg)]]
     60'''9.''' You should now see that the topology has changed and that between the ''"server"'' VM and the ''"right-client"'' VM the link is now named ''"stitched0"''.
     63'''10.''' We will now export this topology to a file by selecting the "View" pull-down and choosing ''"Preview requested document(s)"''. You will now choose "Save to file" to export the RSpec we just modified. For the purpose of this experiment we will assume the file is saved to ''"!MyTopology.rspec"'', but you can choose any name or location, just make a note of it.
     65     [[Image(GENIExperimenter/Graphics:export-to-file.jpg)]]
     68We are now ready to use stitcher to create the stitched topology for our experiment!
     72= Step 3: Run stitcher tool to get resources =
     74The stitcher tools delivers the same features as the Omni tool, but with one major difference: stitcher will submit sliver request at all aggregate in your request RSpec. Let's now set up slivers for the request RSpec generated in the previous section:
     76'''11.'''  Use stitcher to create a sliver, using the slice that we created in the Portal.  The request will use the RSpec that was saved to a file in the setup steps. The output will look something like this:
     78$ stitcher createsliver MySlice MyTopology.rspec
     7911:48:18 INFO     stitcher: Loading agg_nick_cache file '/Users/lnevers/.gcf/agg_nick_cache'
     8011:48:18 INFO     stitcher: Loading config file /Users/lnevers/.gcf/omni_config
     8111:48:18 INFO     stitcher: Setting option useSliceMembers based on omni_config setting
     8211:48:18 INFO     stitcher: Using control framework portal
     8311:48:18 INFO     stitcher: Member Authority is (from config)
     8411:48:18 INFO     stitcher: Slice Authority is (from config)
     8511:48:19 INFO     stitcher: Checking that slice MySlice is valid...
     8611:48:19 INFO     stitcher: Slice expires on 2014-03-17 14:57:35 UTC
     8711:48:20 INFO     stitcher: Stitched reservation will include resources from these aggregates:
     8811:48:20 INFO     stitcher:     <Aggregate wisconsin-ig>
     8911:48:20 INFO     stitcher:     <Aggregate stanford-ig>
     9011:48:20 INFO     stitcher:     <Aggregate ion>
     9111:48:20 INFO     stitch.Aggregate:
     92        Stitcher doing createsliver at
     9311:48:38 INFO     stitch.Aggregate: Allocation at <Aggregate wisconsin-ig> complete.
     9411:48:38 INFO     stitch.Aggregate:
     95        Stitcher doing createsliver at
     9611:48:58 INFO     stitch.Aggregate: Allocation at <Aggregate stanford-ig> complete.
     9711:48:58 INFO     stitch.Aggregate:
     98        Stitcher doing createsliver at
     9911:49:43 INFO     stitch.Aggregate: DCN AM <Aggregate ion>: must wait for status ready....
     10011:49:43 INFO     stitch.Aggregate: Pause 30 seconds to let circuit become ready...
     10111:50:20 INFO     stitch.Aggregate: DCN circuit 74871 is ready
     10211:50:27 INFO     stitch.Aggregate: Allocation at <Aggregate ion> complete.
     10311:50:27 INFO     stitch.launcher: All aggregates are complete.
     10411:50:27 INFO     stitcher: Saved combined reservation RSpec at 3 AMs to file MySlice-manifest-rspec-stitching-combined.xml
     105Stitching success: Reserved resources in slice MySlice at 3 Aggregates (including 1 intermediate aggregate(s) not in the original request), creating 1 link(s).
     108We are now ready to run the experiment!
     110= [ Introduction] =
     111= [ Next:  Execute] =