Changes between Version 16 and Version 17 of PhoebusExperimentGEMINI

Timestamp:

03/20/13 18:06:12 (11 years ago)

Author:

kissel@cis.udel.edu

Comment:

--

PhoebusExperimentGEMINI

@@ -42 +42 @@
 == 4. Create the experiment slice ==
 
-We will do this through Flack with InstaGENI AMs.
+OUr experiment topology will be generated in Flack on InstaGENI racks at Kentucky and Utah.
+
+Use the "Flack GENI Client" link in the bookmarks par to load the Flack interface.
+
+Select UKY and Utah instageni AMs.
 
 [[Image(select_am.png)]]
 
+Create your topology as shown using VM nodes from either UKY or Utah.
+
 [[Image(flack_topo.png)]]
+
+Click on the "i" on each node to configure additional properties, such as the node name and the desired IP addresses.
 
 [[Image(flack_config_node.png)]]
 
+To allow for GEMINI instrumentation, enable the GEMINI extensions in the right-most tab as shown in the screenshot.  Selecting this extension will automatically create an additional node in your experiment for measurement configuration and collection.
+
 [[Image(flack_gemini_button.png)]]
+
+To modify the request RSpec in the following steps, you need to save the RSpec to your local filesystem.  Click on View->Request RSpec to display the XML representation of your topology and save to file as shown.
 
 [[Image(flack_save_request.png)]]
 
-Now we do some editing of the request RSpec. [http://groups.geni.net/geni/attachment/wiki/PhoebusExperimentGEMINI/edit_rspec.sh edit_rspec.sh]
+Now we do some editing of the request RSpec. Either download or save the following script in your working directory.
+
+[http://groups.geni.net/geni/attachment/wiki/PhoebusExperimentGEMINI/edit_rspec.sh edit_rspec.sh]
 
 {{{
@@ -73 +87 @@
 }}}
 
+The script adds extra service elements to each node that will allow a custom script to be executed when the node boots.  In our case, this script will download and install the Phoebus software packages and other supporting scripts needed for the experiment.  Your own experiments may have many such scripts, each of which is completely customizeable.
+
+
+At this point our request RSpec is ready to go.  We now want to interact with the GENI control framework to instantiate our experiment.  In this tutorial, we will use Omni.
+
 First, renew the slice created in Flack via Omni.
 
 [[Image(omni_renew_slice.png)]]
 
-Create the slivers at each AM.  (ig-utah and/or ig-ky)
+You now want to invoke "createsliver" to create the slivers at each AM involved in your experiment topology.  In our case, this is either ig-utah or ig-ky as configured in your Omni configuration file.
 
 [[Image(omni_create_uky.png)]]
 
+
+After the request is submitted, Omni can be used to monitor the slice status.  More conveniently, you can reload the slice in Flack and watch the progress until your slice display turns green.
+
+
 == 5. Instrument the slice ==
+
+Now that the slice is created, you may instrument the slice with GEMINI.  The GENI Desktop provides this same functionality via a browser interface, but here we will use the "instrumentize" scripts available on the UW VM.
+
+Note that you specify your slice name and the location of your SSL certificate when executing these scripts.  
 
 {{{
@@ -90 +117 @@
 geni@GEC16-Tutorials:~/src/GEMINI/geminiv2$ ./gdesktop-instrumentize.py -n ezraslice2 -f ~/.ssl/geni_cert.pem
 }}}
+
+Once these scripts return, your slice has been instrumentized and will begin collecting default, passive measurements.  We will visit the GENI Desktop in later sections, but while the slice is being instrumented, we can use this time time to login and configure our nodes for our experiment.
 
 == 6. Login and configure experiment nodes ==
@@ -150 +179 @@
 Note that this step requires that you first login to your Slice Authority Emulab site.
 
+Explore the desktop.
+
+For our experiment, we'd also like to measure the latency across all of our nodes.  We can use the active measurement configuration page to do so.
+
 [[Image(desktop_psconfig.png)]]
+
+You may add new ping tests under "Schedul BLiPP Test".
 
 [[Image(psconfig_ping.png)]]
@@ -156 +191 @@
 == 8. Run experiments ==
 
+
+
 == 9. View results ==