Changes between Version 27 and Version 28 of GEC13Agenda/ExperimenterWorkflowTutorial/Tutorial

Timestamp:

03/13/12 10:05:07 (12 years ago)

Author:

nriga@bbn.com

Comment:

--

GEC13Agenda/ExperimenterWorkflowTutorial/Tutorial

@@ -73 +73 @@
 In this first exercise we are going to use Omni and Flack in parallel and see how you can do the same thing with either of the tools. 
 
-=== Configure Flack to use your account ===
+=== Configure Flack to use your account===
 Flack is a web based graphical tool. Start firefox (there should be a shortcut in the top bar). On the bookmark toolbar there is an ExptWorkflow folder. Press there 
 and "Open All in Tabs''
@@ -85 +85 @@
 [[Image(flack-login.png, 60%)]]
 
-
-
+Type in your password again. Now you have configured Flack to your personal information. 
+
+=== Listresources in Flack ===
+After you login, you will see a pop-up window that will ask you which AMs you would like to interact with in this session. First of all unclick the All/None checkbox to uncheck all the AMs. Then make sure that you only check '''bbn-pgeni.cm''' and '''utahemulab.cm''', note that there are AMs with similar names make sure you choose these two. 
+
+[[Image(choose-ams.png, 60%)]]
+
+Now Flack will go behind the scenes and invoke listresources in the selected AMs and populate the map. 
+
+===Configure Flack to use your account ===
+While Flack is loading the resources let's understand how the same functionality works with Omni. Omni is configured through a text file that is called omni_config. Go back to the terminal window and go under the directory that corresponds to your user 
+{{{
+cd /home/geni/Tutorials/ExptWorkflow/gpousr##/
+}}}
+
+For user gpousr25, this will look like
+{{{
+cd /home/geni/Tutorials/ExptWorkflow/gpousr25/
+}}}
+
+Open the file called `omni_config` using either vim or emacs. Close to the top of the file you will see two parameters called `default_cf` and `users`. Your username should be at least listed in the user section. Look for the sections in the file that are named `[pgeni]` and  `[gpousr##]`. For example for user gpousr25 these section look like:
+{{{
+[pgeni]
+type = pg
+ch = https://www.emulab.net:443/protogeni/xmlrpc/ch
+sa = https://www.pgeni.gpolab.bbn.com:443/protogeni/xmlrpc/sa
+# Use the following two lines if you are using
+# a certificate with a passphrase
+#cert = ~/Tutorials/ExptWorkflow/gpousr25/ssh/geni_cert.pem
+#key = ~/Tutorials/ExptWorkflow/gpousr25/ssh/geni_cert.pem
+
+# Use the following two lines if you are using 
+# a cleartext cert.
+cert = ~/Tutorials/ExptWorkflow/gpousr25/ssh/geni_cert_ct.pem
+key = ~/Tutorials/ExptWorkflow/gpousr25/ssh/geni_cert_ct.pem
+[gpousr25]
+# Make sure the urn matches the URN of the credential
+urn = urn:publicid:IDN+pgeni.gpolab.bbn.com+user+gpousr25
+
+# Public key to be installed in compute resources. For multiple 
+# keys use a comma separated file
+keys = ~/Tutorials/ExptWorkflow/gpousr25/ssh/geni_key.pub
+}}}
+
+In the pgeni section you configure Omni to use your personal information. The cert and the key attribute point to files that we have manually downloaded from pgeni.gpolab.bbn.com. This is equivalent to the Download action of Flack. 
+
+In the `[gpousr##]` section, the information need for logging-in to reserved compute resources are provided. It includes you unique URN and a public key that would be uploaded to the hosts that you will reserve during the tutorial. 
+
+Another interesting section to look at is the `[aggregate-nicknames]` sections. Flack already knows the URL for all the AMs and present you a list of AMs to choose from using a short, descriptive name. In Omni a user is required to pass the URL for each call to the GENI AM API. In this section the user get a chance to provide short descriptive names to the URLs that are easier to memorize and use. This section should look like :
+{{{
+[aggregate_nicknames]
+# ProtoGENI AMs and PlanetLab central
+pg-gpo=urn:publicid:IDN+pgeni.gpolab.bbn.com+authority+am,https://pgeni.gpolab.bbn.com/protogeni/xmlrpc/am
+pg-utah=,https://www.emulab.net/protogeni/xmlrpc/am
+pg-ky=urn:publicid:IDN+uky.emulab.net+authority+am,https://www.uky.emulab.net/protogeni/xmlrpc/am
+plc=,https://www.planet-lab.org:12346
+
+# Private myplc installations
+pl-gpo=,http://myplc.gpolab.bbn.com:12346/
+pl-clemson=,http://myplc.clemson.edu:12346/
+pl-stanford=,https://myplc.stanford.edu:12346/
+pl-wisconsin=,https://wings-openflow-1.wail.wisc.edu:12346/
+pl-washington=,https://of.cs.washington.edu:12346/
+pl-rutgers=,https://plc.orbit-lab.org:12346/
+pl-indiana=,https://localhost:12346/
+pl-gatech=,https://localhost:2346/
+
+
+# Tutorial OpenFlow AM
+of-tut=,https://foam-tutorial.gpolab.bbn.com:3626/foam/gapi/1
+
+# Other OpenFlow AMs
+of-gpo=,https://foam.gpolab.bbn.com:3626/foam/gapi/1
+of-stanford=,https://openflow4.stanford.edu:3626/foam/gapi/1
+of-clemson=,https://foam.clemson.edu:3626/foam/gapi/1
+of-wisconsin=,https://foam.wail.wisc.edu:3626/foam/gapi/1
+of-rutgers=,https://foam.oflow.cip.gatech.edu:3626/foam/gapi/1
+of-indiana=,https://foam.noc.iu.edu:3626/foam/gapi/1
+of-gatech=,https://nox.orbit-lab.org:3626/foam/gapi/1
+of-nlr=,https://foam.nlr.net:3626/foam/gapi/1
+of-i2=,https://foam.net.internet2.edu:3626/foam/gapi/1
+}}}
+
+==== Clearing the passphrase from your cert ====
+When you first logged in to Flack, you had to type your passphrase (password). Flack cashes this information and re-uses it for the duration of the session. Omni will ask you for the phrase multiple times per command. To save time during the tutorial, we are going to remove the passphrase from your cert. Close the omni_config file and type :
+{{{
+clear_cert.sh
+}}}
+Use the same password as in Flack. For user gpousr25, this looks like
+{{{
+geni@geni-vm:~/Tutorials/ExptWorkflow/gpousr25$ clear_cert.sh 
+Enter pass phrase for ssh/geni_cert.pem:
+writing RSA key
+}}}
+
+'''NOTE''': If you misstype your password and get an error, make sure to remove a file before you start again:
+{{{
+rm -f ssh/geni_cert_ct.pem
+}}}
+
+===== Test configuration ====
+In order to test that our configuration is correct, you can issue a getversion
+command. For this step we have used !PlanetLab's AM, but you can use any
+Aggregate Manager(AM). 
+{{{
+omni.py getversion -a http://www.planet-lab.org:12346
+}}}
+
+Or equivalently using the !PlanetLab nickname:
+{{{
+omni.py getversion -a plc
+}}}
+
+gpousr25 decided to use !PlanetLab central :
+{{{
+geni@geni-vm:~/Tutorials/ExptWorkflow/gpousr25$ omni.py getversion -a plc
+INFO:omni:Loading config file omni_config
+INFO:omni:Using control framework pgeni
+INFO:omni:Substituting AM nickname plc with URL https://www.planet-lab.org:12346, URN unspecified_AM_URN
+INFO:omni:AM URN: unspecified_AM_URN (url: https://www.planet-lab.org:12346) has version:
+INFO:omni:{   'code': {   'am_code': None, 'am_type': 'sfa', 'geni_code': 0},
+    'geni_api': 2,
+    'output': '',
+    'value': {   'code_tag': '2.0-9',
+                 'code_url': 'git://git.onelab.eu/sfa.git@sfa-2.0-9',
+                 'geni_ad_rspec_versions': [   {   'extensions': [   'http://www.protogeni.net/resources/rspec/ext/flack/1',
+                                                                     'http://www.planet-lab.org/resources/sfa/ext/planetlab/1'],
+                                                   'namespace': 'http://www.protogeni.net/resources/rspec/2',
+                                                   'schema': 'http://www.protogeni.net/resources/rspec/2/ad.xsd',
+                                                   'type': 'ProtoGENI',
+                                                   'version': '2'},
+                                               {   'extensions': [   'http://www.protogeni.net/resources/rspec/ext/flack/1',
+                                                                     'http://www.planet-lab.org/resources/sfa/ext/planetlab/1'],
+                                                   'namespace': 'http://www.geni.net/resources/rspec/3',
+                                                   'schema': 'http://www.geni.net/resources/rspec/3/ad.xsd',
+                                                   'type': 'GENI',
+                                                   'version': '3'},
+                                               {   'extensions': [],
+                                                   'namespace': None,
+                                                   'schema': None,
+                                                   'type': 'SFA',
+                                                   'version': '1'}],
+                 'geni_api': 2,
+                 'geni_api_versions': {   '2': 'http://planet-lab.org:12346'},
+                 'geni_request_rspec_versions': [   {   'extensions': [   'http://www.protogeni.net/resources/rspec/ext/flack/1',
+                                                                          'http://www.planet-lab.org/resources/sfa/ext/planetlab/1'],
+                                                        'namespace': 'http://www.protogeni.net/resources/rspec/2',
+                                                        'schema': 'http://www.protogeni.net/resources/rspec/2/request.xsd',
+                                                        'type': 'ProtoGENI',
+                                                        'version': '2'},
+                                                    {   'extensions': [   'http://www.protogeni.net/resources/rspec/ext/flack/1',
+                                                                          'http://www.planet-lab.org/resources/sfa/ext/planetlab/1'],
+                                                        'namespace': 'http://www.geni.net/resources/rspec/3',
+                                                        'schema': 'http://www.geni.net/resources/rspec/3/request.xsd',
+                                                        'type': 'GENI',
+                                                        'version': '3'},
+                                                    {   'extensions': [],
+                                                        'namespace': None,
+                                                        'schema': None,
+                                                        'type': 'SFA',
+                                                        'version': '1'}],
+                 'hostname': 'quagga.cs.princeton.edu',
+                 'hrn': 'plc',
+                 'interface': 'aggregate',
+                 'sfa': 2,
+                 'testbed': 'myplc',
+                 'urn': 'urn:publicid:IDN++plc'}}
+INFO:omni: ------------------------------------------------------------
+INFO:omni: Completed getversion:
+
+  Options as run:
+                aggregate: plc
+                framework: pgeni
+                native: True
+
+  Args: getversion
+
+  Result Summary: 
+Got version for 1 out of 1 aggregates
+ 
+INFO:omni: ============================================================
+geni@geni-vm:~/Tutorials/ExptWorkflow/gpousr25$
+}}}
+
+=== List Resources in Omni ===
+Flack goes behind the scenes and call listresources for the AMs that you chose, and draws the resources in a map. In Omni in order to see what is available in each AM you will have to manually invoke listreouces
 
 == 1. Configure Omni ==