Changes between Version 1 and Version 2 of GENIExperimenter/ExperimentExample-gcf2


Ignore:
Timestamp:
09/18/12 11:01:57 (7 years ago)
Author:
lnevers@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIExperimenter/ExperimentExample-gcf2

    v1 v2  
    55This page uses gcf 2.0 or higher to demonstrate a GENI Experiment. If you are using gcf 1.6.2 or earlier, see the [http://groups.geni.net/geni/wiki/GENIExperimenter/ExperimentExample Experiment Example] using gcf 1.X tools.
    66
    7 This page illustrates an operational example for the [wiki:HowToUseOmni Omni How-to] page capturing the actions required to run an experiment using multiple resource aggregates and with user credentials from the GPO ProtoGENI Clearinghouse pgeni.gpolab.bbn.com. Details on how credentials are set up can be found in the [wiki:HowToUseOmni#a1.GetGENICredentials GENI Credentials] section of the main [wiki:HowToUseOmni Omni How-To] page. In this experiment, a total of 5 nodes are requested, with 2 nodes from the Emulab (PG) aggregate and 3 nodes from the !PlanetLab (PL) aggregate.   
     7This page illustrates an operational example for the [wiki:HowToUseOmni Omni How-to] page capturing the actions required to run an experiment using multiple resource aggregates and with user credentials from the GPO ProtoGENI Clearinghouse pgeni.gpolab.bbn.com. Details on how credentials are set up can be found in the [wiki:HowToUseOmni#a1.GetGENICredentials GENI Credentials] section of the main [wiki:HowToUseOmni Omni How-To] page. In this experiment, a total of 4 nodes are requested, with 2 nodes from the Emulab (PG) aggregate and 2 nodes from the !PlanetLab (PL) aggregate.   
    88
    99This page does not cover the installation of the Omni client, as it is well [http://trac.gpolab.bbn.com/gcf/wiki/Omni documented].
     
    172172== Renew your slice ==
    173173
    174 Note in the above output that our new slice expires soon. Any resources that you will reserve as part of your slice can not last longer than your slice, and will go away when the reservation expires. For your experiment be sure to renew your slice for the duration of your experiment. Here we only slightly extend the slice lifetime.
     174Note in the above output that our new slice expires soon. Any resources that you will reserve as part of your slice can not last longer than your slice, and will go away when the reservation expires. For your experiment be sure to renew your slice for the duration of your experiment. Here we  extend the slice lifetime:
    175175
    176176{{{
     
    294294}}}
    295295
    296 == Add PlanetLab resources to GPO PG slice ==
    297 
    298 To request three PlanetLab nodes, the following RSpec named planet.rspec was used for this example; your RSpec will be specific to your experiment requirements.
     296== Add !PlanetLab resources to GPO PG slice ==
     297
     298To request three !PlanetLab nodes, the following RSpec named planet.rspec was used for this example; your RSpec will be specific to your experiment requirements.
    299299
    300300This example uses ProtoGENI V2 RSpec format, to generate the ProtoGENI V2 request from the Advertisement:
     
    321321       http://www.protogeni.net/resources/rspec/ext/emulab/1
    322322       http://www.protogeni.net/resources/rspec/ext/emulab/1/ptop_extension.xsd">
    323   <node
    324     component_id="urn:publicid:IDN+plc:rit+node+planet2.cs.rit.edu"
    325     component_manager_id="urn:publicid:IDN+plc+authority+am"
    326     component_name="planet2.cs.rit.edu" exclusive="false"
    327     client_id="ritpl2">   
    328       <hardware_type name="plab-pc"/>   
    329       <hardware_type name="pc"/>   
    330       <location country="us" latitude="43.0844" longitude="-77.6799"/>   
    331       <sliver_type name="plab-vnode"/>   
    332   </node> 
    333   <node
     323   <node
    334324    component_id="urn:publicid:IDN+plc:williams+node+planetlab3.williams.edu"
    335325    component_manager_id="urn:publicid:IDN+plc+authority+am"
     
    354344}}}
    355345
    356 To request the three !PlanetLab nodes, a sliver was created within !PlanetLab with the RSpec above using the following command:
    357 
    358 {{{
    359 $ omni.py -a plc -o createsliver --api-version 2  lnevers-1slice planet.rspec
    360 INFO:omni:Loading config file omni_config
    361 INFO:omni:Using control framework pgeni
    362 INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    363 INFO:omni:Creating sliver(s) from rspec file planet.rspec for slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice
    364 INFO:omni:Writing result of createsliver for slice: lnevers-1slice at AM: http://www.planet-lab.org:12346 to file lnevers-1slice-manifest-rspec-www-planet-lab-org.xml
     346To request the two !PlanetLab nodes, a sliver was created within !PlanetLab with the RSpec above using the following command:
     347
     348{{{
     349$ omni.py -a plc createsliver lnevers-1slice planetlab.rspec -o
     350INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     351INFO:omni:Using control framework pg
     352INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-09-24 00:00:00 UTC
     353INFO:omni:Substituting AM nickname plc with URL https://www.planet-lab.org:12346, URN unspecified_AM_URN
     354INFO:omni:Substituting AM nickname plc with URL https://www.planet-lab.org:12346, URN unspecified_AM_URN
     355INFO:omni:Creating sliver(s) from rspec file planetlab.rspec for slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice
     356INFO:omni:Got return from CreateSliver for slice lnevers-1slice at https://www.planet-lab.org:12346:
    365357INFO:omni:Writing to 'lnevers-1slice-manifest-rspec-www-planet-lab-org.xml'
     358INFO:omni:Wrote result of createsliver for slice: lnevers-1slice at AM: https://www.planet-lab.org:12346
     359to file lnevers-1slice-manifest-rspec-www-planet-lab-org.xml
    366360INFO:omni: ------------------------------------------------------------
    367361INFO:omni: Completed createsliver:
    368362
    369363  Options as run:
    370                 aggregate: http://www.planet-lab.org:12346
    371                 api_version: 2
    372                 framework: pgeni
    373                 native: True
    374                 output: True
    375 
    376   Args: createsliver lnevers-1slice planet.rspec
    377 
    378   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    379 Reserved resources on http://www.planet-lab.org:12346.
     364                aggregate: ['plc']
     365                framework: pg
     366                getversionCacheName: /home/lnevers/.gcf/get_version_cache.json
     367                output: True
     368
     369  Args: createsliver lnevers-1slice planetlab.rspec
     370
     371  Result Summary: Got Reserved resources RSpec from www-planet-lab-org
    380372   Saved createsliver results to lnevers-1slice-manifest-rspec-www-planet-lab-org.xml. 
    381373INFO:omni: ============================================================
     
    386378#!xml
    387379<?xml version="1.0" ?>
    388 <!-- Reserved resources for:
    389         Slice: lnevers-1slice
    390         At AM:
    391         URL: http://www.planet-lab.org:12346
     380  <!-- Reserved resources for:
     381        Slice: lnevers-1slice
     382        at AM:
     383        URN: unspecified_AM_URN
     384        URL: https://www.planet-lab.org:12346
    392385 -->
    393 <rspec expires="2012-01-23T13:12:32Z" generated="2012-01-09T18:12:35Z" type="manifest" xmlns="http://www.protogeni.net/resources/rspec/2" xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" x
    394 mlns:planetlab="http://www.planet-lab.org/resources/sfa/ext/planetlab/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.protogeni.net/resources/rspec/2 http://www.proto
    395 geni.net/resources/rspec/2/manifest.xsd http://www.planet-lab.org/resources/sfa/ext/planetlab/1 http://www.planet-lab.org/resources/sfa/ext/planetlab/1/planetlab.xsd"> 
    396     <node client_id="plnode-03.gpolab.bbn.com" component_id="urn:publicid:IDN+plc:bbn+node+plnode-03.gpolab.bbn.com" component_manager_id="urn:publicid:IDN+plc+authority+cm" component_name="plnode-03.gpolab
    397 .bbn.com" exclusive="false" sliver_id="urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:23324:13627:0">   
     386  <rspec expires="2012-10-02T10:21:35Z" generated="2012-09-18T14:21:41Z" type="manifest"
     387  xmlns="http://www.protogeni.net/resources/rspec/2"
     388  xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1"
     389  xmlns:planetlab="http://www.planet-lab.org/resources/sfa/ext/planetlab/1"
     390  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     391  xsi:schemaLocation="http://www.protogeni.net/resources/rspec/2
     392  http://www.protogeni.net/resources/rspec/2/manifest.xsd
     393  http://www.planet-lab.org/resources/sfa/ext/planetlab/1
     394  http://www.planet-lab.org/resources/sfa/ext/planetlab/1/planetlab.xsd"> 
     395
     396    <node client_id="williamspl3" component_id="urn:publicid:IDN+plc:williams+node+planetlab3.williams.edu"
     397    component_manager_id="urn:publicid:IDN+plc+authority+cm" component_name="planetlab3.williams.edu"
     398    exclusive="false" sliver_id="urn:publicid:IDN+plc:pgeni.gpolab.bbn.com+slice+lnevers-1slice-10860">   
     399        <hardware_type name="plab-pc"/>   
     400        <hardware_type name="pc"/>   
     401        <location country="unknown" latitude="42.71" longitude="-73.2"/>   
     402        <interface client_id="10860:1643" component_id="urn:publicid:IDN+plc+interface+node10860:eth0"/>   
     403        <services>     
     404            <login authentication="ssh-keys" hostname="planetlab3.williams.edu" port="22"
     405              username="pgenigpolabbbncom_lnevers1slice"/>     
     406        </services>   
     407        <sliver_type name="plab-vserver"/>   
     408    </node> 
     409    <node client_id="gpopl3" component_id="urn:publicid:IDN+plc:bbn+node+plnode-03.gpolab.bbn.com"
     410    component_manager_id="urn:publicid:IDN+plc+authority+cm" component_name="plnode-03.gpolab.bbn.com"
     411    exclusive="false" sliver_id="urn:publicid:IDN+plc:pgeni.gpolab.bbn.com+slice+lnevers-1slice-13627">   
    398412        <hardware_type name="plab-pc"/>   
    399413        <hardware_type name="pc"/>   
     
    401415        <interface client_id="13627:2918" component_id="urn:publicid:IDN+plc+interface+node13627:eth0"/>   
    402416        <services>     
    403             <login authentication="ssh-keys" hostname="plnode-03.gpolab.bbn.com" port="22" username="pgenigpolabbbncom_lnevers1slice"/>     
    404         </services>   
    405         <sliver_type name="plab-vserver"/>   
    406     </node> 
    407     <node client_id="planetlab3.williams.edu" component_id="urn:publicid:IDN+plc:williams+node+planetlab3.williams.edu" component_manager_id="urn:publicid:IDN+plc+authority+cm" component_name="planetlab3.wi
    408 lliams.edu" exclusive="false" sliver_id="urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:23324:10860:0">   
    409         <hardware_type name="plab-pc"/>   
    410         <hardware_type name="pc"/>   
    411         <location country="unknown" latitude="42.71" longitude="-73.2"/>   
    412         <interface client_id="10860:1643" component_id="urn:publicid:IDN+plc+interface+node10860:eth0"/>   
    413         <services>     
    414             <login authentication="ssh-keys" hostname="planetlab3.williams.edu" port="22" username="pgenigpolabbbncom_lnevers1slice"/>     
     417            <login authentication="ssh-keys" hostname="plnode-03.gpolab.bbn.com" port="22"
     418             username="pgenigpolabbbncom_lnevers1slice"/>     
    415419        </services>   
    416420        <sliver_type name="plab-vserver"/>   
     
    419423}}}
    420424
    421 Note that your login for your nodes is available by running {{{sliverstatus}}}.
     425Note that your login for your nodes is available by running {{{sliverstatus}}} or by running the readyToLogin available in the examples directory in the gcf package.
    422426
    423427As part of the ''createsliver'' operation for PL nodes, Omni uploads the user SSH keys based on the [users] section of the omni_config. If you have problems in setting up your slice, contact us at [mailto:help@geni.net].
     
    428432
    429433{{{
    430 <?xml version="1.0" ?>
    431 <!-- Reserved resources for:
    432         Slice: lnevers-1slice
    433         At AM:
    434         URL: http://www.planet-lab.org:12346
    435  -->
    436 
    437 <rspec expires="2012-01-23T13:12:32Z" generated="2012-01-09T18:12:35Z" type="manifest" xmlns="http://www.protogeni.net/resources/rspec/2" xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" x
    438 mlns:planetlab="http://www.planet-lab.org/resources/sfa/ext/planetlab/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.protogeni.net/resources/rspec/2 http://www.proto
    439 geni.net/resources/rspec/2/manifest.xsd http://www.planet-lab.org/resources/sfa/ext/planetlab/1 http://www.planet-lab.org/resources/sfa/ext/planetlab/1/planetlab.xsd"> 
    440     <node client_id="plnode-03.gpolab.bbn.com" component_id="urn:publicid:IDN+plc:bbn+node+plnode-03.gpolab.bbn.com" component_manager_id="urn:publicid:IDN+plc+authority+cm" component_name="plnode-03.gpolab
    441 .bbn.com" exclusive="false" sliver_id="urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:23324:13627:0">   
    442         <hardware_type name="plab-pc"/>   
    443         <hardware_type name="pc"/>   
    444         <location country="unknown" latitude="42.3907" longitude="-71.1478"/>   
    445         <interface client_id="13627:2918" component_id="urn:publicid:IDN+plc+interface+node13627:eth0"/>   
    446         <services>     
    447             <login authentication="ssh-keys" hostname="plnode-03.gpolab.bbn.com" port="22" username="pgenigpolabbbncom_lnevers1slice"/>     
    448         </services>   
    449 $ omni.py -a pg-utah lnevers-1slice
    450 INFO:omni:Loading config file omni_config
    451 INFO:omni:Using control framework pgeni
    452 INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    453 INFO:omni:Status of Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:
    454 INFO:omni:Sliver status for Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice at AM URL https://www.emulab.net/protogeni/xmlrpc/am
    455 INFO:omni:{'geni_resources': [{'geni_error': '',
    456                      'geni_status': 'ready',
    457                      'geni_urn': 'urn:publicid:IDN+emulab.net+sliver+68392',
    458                      'pg_manifest': {'attributes': {'component_id': 'urn:publicid:IDN+emulab.net+node+pc333',
    459                                                     'component_manager_id': 'urn:publicid:IDN+emulab.net+authority+cm',
    460                                                     'exclusive': 'true',
    461                                                     'sliver_id': 'urn:publicid:IDN+emulab.net+sliver+68392',
    462                                                     'virtual_id': 'geni1',
    463                                                     'virtualization_type': 'emulab-vnode',
    464                                                     'xmlns': 'http://www.protogeni.net/resources/rspec/2',
    465                                                     'xmlns:emulab': 'http://www.protogeni.net/resources/rspec/ext/emulab/1'},
    466                                      'children': [{'attributes': {'name': 'raw-pc'},
    467                                                    'children': [],
    468                                                    'name': 'sliver_type'},
    469                                                   {'attributes': {'name': 'pc333'},
    470                                                    'children': [],
    471                                                    'name': 'emulab:vnode'},
    472                                                   {'attributes': {'name': 'geni1.lnevers-1slice.pgeni-gpolab-bbn-com.emulab.net'},
    473                                                    'children': [],
    474                                                    'name': 'host'},
    475                                                   {'attributes': {},
    476                                                    'children': [{'attributes': {'authentication': 'ssh-keys',
    477                                                                                 'hostname': 'pc333.emulab.net',
    478                                                                                 'port': 22,
    479                                                                                 'username': 'lnevers'},
    480                                                                  'children': [],
    481                                                                  'name': 'login'}],
    482                                                    'name': 'services'}],
    483                                      'name': 'node'},
    484                      'pg_status': 'ready'},
    485                     {'geni_error': '',
    486                      'geni_status': 'ready',
    487                      'geni_urn': 'urn:publicid:IDN+emulab.net+sliver+68393',
    488                      'pg_manifest': {'attributes': {'component_id': 'urn:publicid:IDN+emulab.net+node+pc350',
    489                                                     'component_manager_id': 'urn:publicid:IDN+emulab.net+authority+cm',
    490                                                     'exclusive': 'true',
    491                                                     'sliver_id': 'urn:publicid:IDN+emulab.net+sliver+68393',
    492                                                     'virtual_id': 'geni2',
    493                                                     'virtualization_type': 'emulab-vnode',
    494                                                     'xmlns': 'http://www.protogeni.net/resources/rspec/2',
    495                                                     'xmlns:emulab': 'http://www.protogeni.net/resources/rspec/ext/emulab/1'},
    496                                      'children': [{'attributes': {'name': 'raw-pc'},
    497                                                    'children': [],
    498                                                    'name': 'sliver_type'},
    499                                                   {'attributes': {'name': 'pc350'},
    500                                                    'children': [],
    501                                                    'name': 'emulab:vnode'},
    502                                                   {'attributes': {'name': 'geni2.lnevers-1slice.pgeni-gpolab-bbn-com.emulab.net'},
    503                                                    'children': [],
    504                                                    'name': 'host'},
    505                                                   {'attributes': {},
    506                                                    'children': [{'attributes': {'authentication': 'ssh-keys',
    507                                                                                 'hostname': 'pc350.emulab.net',
    508                                                                                 'port': 22,
    509                                                                                 'username': 'lnevers'},
    510                                                                  'children': [],
    511                                                                  'name': 'login'}],
    512                                                    'name': 'services'}],
    513                                      'name': 'node'},
    514                      'pg_status': 'ready'}],
    515  'geni_status': 'ready',
    516  'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice',
    517  'pg_expires': '2012-01-14 11:10:10',
    518  'pg_status': 'ready'}
    519 INFO:omni: ------------------------------------------------------------
    520 INFO:omni: Completed sliverstatus:
    521 
    522   Options as run:
    523                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    524                 framework: pgeni
    525                 native: True
    526 
    527   Args: sliverstatus lnevers-1slice
    528 
    529   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    530 Returned status of slivers on 1 of 1 possible aggregates.
    531 INFO:omni: ============================================================
    532 }}}
    533 
    534 To check the ''sliverstatus'' for PL resources, but this time saving the status output to a file, the following command was issued:
    535 
    536 {{{
    537 $ omni.py -a plc -o sliverstatus -t geni 3 --api-version 2 lnevers-1slice
    538 INFO:omni:Loading config file omni_config
    539 INFO:omni:Using control framework pgeni
    540 INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    541 INFO:omni:Status of Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:
    542 INFO:omni:Writing to 'lnevers-1slice-sliverstatus-www-planet-lab-org.json'
    543 INFO:omni:Sliver status for Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice at AM URL http://www.planet-lab.org:12346
    544 INFO:omni: ------------------------------------------------------------
    545 INFO:omni: Completed sliverstatus:
    546 
    547   Options as run:
    548                 aggregate: http://www.planet-lab.org:12346
    549                 api_version: 2
    550                 framework: pgeni
    551                 native: True
    552                 output: True
    553                 rspectype: ('geni', '3')
    554 
    555   Args: sliverstatus lnevers-1slice
    556 
    557   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    558 Saved sliverstatus on lnevers-1slice at AM http://www.planet-lab.org:12346 to file lnevers-1slice-sliverstatus-www-planet-lab-org.json.
    559 Returned status of slivers on 1 of 1 possible aggregates.
    560 INFO:omni: ============================================================
    561 }}}
    562 
    563 And the saved status is:
    564 {{{
    565 {'geni_resources': [{'geni_error': '',
    566                      'geni_status': 'ready',
    567                      'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+lnevers-1slice:23324:13627:0',
    568                      'pl_boot_state': 'boot',
    569                      'pl_hostname': 'plnode-03.gpolab.bbn.com',
    570                      'pl_last_contact': '2012-01-09T13:15:59Z'},
    571                     {'geni_error': '',
    572                      'geni_status': 'ready',
    573                      'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+lnevers-1slice:23324:10860:0',
    574                      'pl_boot_state': 'boot',
    575                      'pl_hostname': 'planetlab3.williams.edu',
    576                      'pl_last_contact': '2012-01-09T13:13:23Z'}],
    577  'geni_status': 'ready',
    578  'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+lnevers-1slice',
    579  'pl_expires': '2012-01-23T13:12:32Z',
    580  'pl_login': 'pgenigpolabbbncom_lnevers1slice'}
    581 }}}
    582 
    583 
    584 A lot of very useful information is reported for the ''sliverstatus'' output including which hosts are assigned to you and for how long. For PlanetLab, notice the value in the 'pl_login' field, which is the login to be used to access the nodes. For a slice across multiple aggregates, you should pay close attention to the expiration time for each aggregate sliver (pg_expires & pl_expires).  Note that slice expiration time is also available in the output of many commands.
     434$ omni.py -a plc sliverstatus lnevers-1slice -o
     435$ omni.py -a pg-utah sliverstatus lnevers-1slice -o   
     436}}}
     437
     438Review the output file and check for the '' "geni_status" '' to be '' "ready" '' to verify that the requested compute resources are ready for use.  A lot of very useful information is reported for the ''sliverstatus'' output including which hosts are assigned to you and for how long. For !PlanetLab, notice the value in the 'pl_login' field, which is the login to be used to access the nodes. For a slice across multiple aggregates, you should pay close attention to the expiration time for each aggregate sliver (pg_expires & pl_expires).  Note that slice expiration time is also available in the output of many commands.
    585439
    586440Also note that by using the ''aggregates'' option in your ''omni_config'', you can configure Omni to talk to all the aggregates in your experiment, and only those aggregates. Then ''sliverstatus'' will get full status for you in a single call.
    587441
    588 Note that the Emulab PG aggregate limits slivers to a duration of 5 days and you may need to extend the sliver expiration.  For this example the pg_expires is ''2012-01-14 11:10:10'' while the pl_expires is ''2012-01-23T13:12:32Z''. Make sure that each expiration time meets your requirements for your experiment's duration.  If you need to extend the expiration, you can use the Omni ''renewsliver'' to extend each sliver. The following command is issued to modify the expiration time for the ProtoGENI resources:
    589 
    590 {{{
    591 $ omni.py -a pg-utah renewsliver lnevers-1slice '2012-01-14 16:10:10'
    592 INFO:omni:Loading config file omni_config
    593 INFO:omni:Using control framework pgeni
    594 INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    595 INFO:omni:Renewing Sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice until 2012-01-14 16:10:10+00:00 (UTC)
    596 INFO:omni:Renewed sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice at unspecified_AM_URN (https://www.emulab.net/protogeni/xmlrpc/am) until 2012-01-14T16:10:10+00:00 (UTC)
    597 INFO:omni: ------------------------------------------------------------
    598 INFO:omni: Completed renewsliver:
    599 
    600   Options as run:
    601                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    602                 framework: pgeni
    603                 native: True
    604 
    605   Args: renewsliver lnevers-1slice 2012-01-14 16:10:10
    606 
    607   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    608 Renewed sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice at unspecified_AM_URN (https://www.emulab.net/protogeni/xmlrpc/am) until 2012-01-14T16:10:10+00:00 (UTC)
    609 INFO:omni: ============================================================
    610 }}}
    611 
    612 Check status again and you will notice that the ''pg_expires'' has been modified:
    613 
    614 {{{
    615 $ omni.py -a pg-utah sliverstatus lnevers-1slice
    616 INFO:omni:Loading config file omni_config
    617 INFO:omni:Using control framework pgeni
    618 
    619 .....
    620  'geni_status': 'ready',
    621  'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice',
    622  'pg_expires': '2012-01-14 09:10:10',
    623  'pg_status': 'ready'}
    624 INFO:omni: ------------------------------------------------------------
    625 INFO:omni: Completed sliverstatus:
    626 
    627   Options as run:
    628                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    629                 framework: pgeni
    630                 native: True
    631 
    632   Args: sliverstatus lnevers-1slice
    633 
    634   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    635 Returned status of slivers on 1 of 1 possible aggregates.
    636 INFO:omni: ============================================================
    637 }}}
    638442
    639443== Find Slivers and List Resources in your Slice ==
     
    643447Run:
    644448{{{
    645 $ omni.py -a pg-utah -o -t ProtoGENI 2 listresources lnevers-1slice
    646 INFO:omni:Loading config file omni_config
    647 INFO:omni:Using control framework pgeni
     449$ omni.py -a pg-utah -o listresources lnevers-1slice
     450INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     451INFO:omni:Using control framework pg
    648452INFO:omni:Saving output to a file.
     453INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-09-24 00:00:00 UTC
    649454INFO:omni:Gathering resources reserved for slice lnevers-1slice.
     455INFO:omni:Substituting AM nickname pg-utah with URL https://www.emulab.net/protogeni/xmlrpc/am/2.0, URN unspecified_AM_URN
    650456INFO:omni:Listed resources on 1 out of 1 possible aggregates.
    651 INFO:omni:Writing to 'lnevers-1slice-rspec-www-emulab-net-protogeni.xml'
     457INFO:omni:Writing to 'lnevers-1slice-manifest-rspec-www-emulab-net-protogeniv2.xml'
    652458INFO:omni: ------------------------------------------------------------
    653459INFO:omni: Completed listresources:
    654460
    655461  Options as run:
    656                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    657                 framework: pgeni
    658                 native: True
    659                 output: True
    660                 rspectype: ('ProtoGENI', '2')
     462                aggregate: ['pg-utah']
     463                framework: pg
     464                getversionCacheName: /home/lnevers/.gcf/get_version_cache.json
     465                output: True
    661466
    662467  Args: listresources lnevers-1slice
    663468
    664   Result Summary: Retrieved resources for slice lnevers-1slice from 1 aggregates.
    665 Wrote rspecs from 1 aggregates to 1 files
    666 Saved listResources RSpec at unspecified_AM_URN to file lnevers-1slice-rspec-www-emulab-net-protogeni.xml. 
    667 INFO:omni: ============================================================
    668 
    669 }}}
    670 
    671 The result will be a file (''lnevers-1slice-rspec-www-emulab-net.xml'') of the resources in your slice at that aggregate.
     469  Result Summary: Queried resources for slice lnevers-1slice from 1 of 1 aggregate(s).
     470Wrote rspecs from 1 aggregate(s) to 1 file(s)
     471Saved listresources RSpec at 'unspecified_AM_URN' to file lnevers-1slice-manifest-rspec-www-emulab-net-protogeniv2.xml; 
     472INFO:omni: ============================================================
     473}}}
     474
     475The result will be a file (''lnevers-1slice-manifest-rspec-www-emulab-net-protogeniv2.xml'') of the resources in your slice at that aggregate.
     476
     477You may also check for the sliver status and the login information with the gcf ''readiToLogin.py'' script. This is the login information for the PG Emulab sliver:
     478{{{
     479$ ./examples/readyToLogin.py -a pg-utah lnevers-1slice   
     480INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     481INFO:omni:Using control framework pg
     482Key file [/home/lnevers/.ssh/luisa-mac-id_rsa] does NOT exist.
     483Key file [/home/lnevers/.ssh/sendaria-id_rsa] does NOT exist.
     484INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     485INFO:omni:Using control framework pg
     486INFO:omni:Substituting AM nickname pg-utah with URL https://www.emulab.net/protogeni/xmlrpc/am/2.0, URN unspecified_AM_URN
     487 .....
     488================================================================================
     489SSH CONFIGURATION INFO for User lnevers
     490================================================================================
     491 
     492Host geni2
     493  Port 22
     494  HostName pc484.emulab.net
     495  User lnevers
     496  IdentityFile /home/lnevers/.ssh/id_rsa
     497 
     498Host geni1
     499  Port 22
     500  HostName pc505.emulab.net
     501  User lnevers
     502  IdentityFile /home/lnevers/.ssh/id_rsa
     503
     504================================================================================
     505LOGIN INFO for AM: https://www.emulab.net/protogeni/xmlrpc/am/2.0
     506================================================================================
     507
     508geni2's geni_status is: ready (am_status:ready)
     509User lnevers logins to geni2 using:
     510        xterm -e ssh -i /home/lnevers/.ssh/id_rsa lnevers@pc484.emulab.net &
     511
     512
     513geni1's geni_status is: ready (am_status:ready)
     514User lnevers logins to geni1 using:
     515        xterm -e ssh -i /home/lnevers/.ssh/id_rsa lnevers@pc505.emulab.net &
     516
     517}}}
     518
     519This is the login information for the !PlanetLab nodes:
     520{{{
     521$ ./examples/readyToLogin.py -a plc lnevers-1slice
     522INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     523INFO:omni:Using control framework pg
     524Key file [/home/lnevers/.ssh/luisa-mac-id_rsa] does NOT exist.
     525Key file [/home/lnevers/.ssh/sendaria-id_rsa] does NOT exist.
     526INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     527INFO:omni:Using control framework pg
     528INFO:omni:Substituting AM nickname plc with URL https://www.planet-lab.org:12346, URN unspecified_AM_URN
     529INFO:omni:AM URN: unspecified_AM_URN (url: https://www.planet-lab.org:12346) has version:
     530
     531 ....
     532
     533================================================================================
     534SSH CONFIGURATION INFO for User pgenigpolabbbncom_lnevers1slice
     535================================================================================
     536 
     537Host planetlab3.williams.edu
     538  Port 22
     539  HostName planetlab3.williams.edu
     540  User pgenigpolabbbncom_lnevers1slice
     541  IdentityFile /home/lnevers/.ssh/id_rsa
     542
     543Host plnode-03.gpolab.bbn.com
     544  Port 22
     545  HostName plnode-03.gpolab.bbn.com
     546  User pgenigpolabbbncom_lnevers1slice
     547  IdentityFile /home/lnevers/.ssh/id_rsa
     548
     549================================================================================
     550LOGIN INFO for AM: https://www.planet-lab.org:12346
     551================================================================================
     552
     553planetlab3.williams.edu's geni_status is: failed (am_status:reinstall)
     554User pgenigpolabbbncom_lnevers1slice logins to planetlab3.williams.edu using:
     555        xterm -e ssh -i /home/lnevers/.ssh/id_rsa pgenigpolabbbncom_lnevers1slice@planetlab3.williams.edu &
     556
     557plnode-03.gpolab.bbn.com's geni_status is: ready (am_status:boot)
     558User pgenigpolabbbncom_lnevers1slice logins to plnode-03.gpolab.bbn.com using:
     559        xterm -e ssh -i /home/lnevers/.ssh/id_rsa pgenigpolabbbncom_lnevers1slice@plnode-03.gpolab.bbn.com &
     560}}}
     561
    672562
    673563== Verify Resources and run your Experiment ==
     
    696586When the experiment is completed you should release the resources by deleting the resource sliver for each of the Resource Aggregates used in the Experiment. In the example experiment used in this page, the ProtoGENI sliver was deleted as follows:
    697587{{{
    698 $ omni.py -a pg-utah deletesliver lnevers-1slice
    699 INFO:omni:Loading config file omni_config
    700 INFO:omni:Using control framework pgeni
    701 INFO:omni:Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice on unspecified_AM_URN at https://www.emulab.net/protogeni/xmlrpc/am
     588$  omni.py -a pg-utah deletesliver lnevers-1slice
     589INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     590INFO:omni:Using control framework pg
     591INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-09-24 00:00:00 UTC
     592INFO:omni:Substituting AM nickname pg-utah with URL https://www.emulab.net/protogeni/xmlrpc/am/2.0, URN unspecified_AM_URN
     593INFO:omni:Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice on unspecified_AM_URN at https://www.emulab.net/protogeni/xmlrpc/am/2.0
    702594INFO:omni: ------------------------------------------------------------
    703595INFO:omni: Completed deletesliver:
    704596
    705597  Options as run:
    706                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    707                 framework: pgeni
    708                 native: True
     598                aggregate: ['pg-utah']
     599                framework: pg
     600                getversionCacheName: /home/lnevers/.gcf/get_version_cache.json
    709601
    710602  Args: deletesliver lnevers-1slice
    711603
    712   Result Summary: Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice on unspecified_AM_URN at https://www.emulab.net/protogeni/xmlrpc/am
    713 INFO:omni: ============================================================
    714 }}}
    715 
    716 Also the Planetlab sliver was deleted as follows:
    717 {{{
    718 
     604  Result Summary: Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice on unspecified_AM_URN at https://www.emulab.net/protogeni/xmlrpc/am/2.0
     605INFO:omni: ============================================================
     606}}}
     607
     608Also the !PlanetLab sliver was deleted as follows:
     609{{{
     610$ omni.py -a plc deletesliver lnevers-1slice
     611INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     612INFO:omni:Using control framework pg
     613INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-09-24 00:00:00 UTC
     614INFO:omni:Substituting AM nickname plc with URL https://www.planet-lab.org:12346, URN unspecified_AM_URN
     615INFO:omni:Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice on unspecified_AM_URN at https://www.planet-lab.org:12346
     616INFO:omni: ------------------------------------------------------------
     617INFO:omni: Completed deletesliver:
     618
     619  Options as run:
     620                aggregate: ['plc']
     621                framework: pg
     622                getversionCacheName: /home/lnevers/.gcf/get_version_cache.json
     623
     624  Args: deletesliver lnevers-1slice
     625
     626  Result Summary: Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice on unspecified_AM_URN at https://www.planet-lab.org:12346
     627INFO:omni: ============================================================
    719628}}}
    720629
    721630== List your Slices ==
     631
    722632You are responsible for remembering your slices, and what resources you have.
    723633
     
    726636For example:
    727637{{{
    728 $ omni.py -a plc deletesliver  -t geni 3 --api-version 2 lnevers-1slice
    729 INFO:omni:Loading config file omni_config
    730 INFO:omni:Using control framework pgeni
    731 INFO:omni:Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice on unspecified_AM_URN at http://www.planet-lab.org:12346
    732 INFO:omni: ------------------------------------------------------------
    733 INFO:omni: Completed deletesliver:
    734 
    735   Options as run:
    736                 aggregate: http://www.planet-lab.org:12346
    737                 api_version: 2
    738                 framework: pgeni
    739                 native: True
    740                 rspectype: ('geni', '3')
    741 
    742   Args: deletesliver lnevers-1slice
    743 
    744   Result Summary: Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice on unspecified_AM_URN at http://www.planet-lab.org:12346
    745 INFO:omni: ============================================================
    746 }}}
    747 
    748 Then, to see what resources you have in this slice at Planetlab:
    749 {{{
    750 $ omni.py -f pgeni -a plc -t geni 3 --api-version 2 listresources lnevers-1slice
    751 }}}
    752 
    753 The results above show that the returned RSpec contains no nodes - as expected, since we had already deleted our sliver there.
     638$ omni.py listmyslices lnevers
     639INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     640INFO:omni:Using control framework pg
     641INFO:omni:User 'lnevers' has slice(s):
     642        urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice
     643        urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+foam-lnevers
     644        urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-exp1
     645INFO:omni: ------------------------------------------------------------
     646INFO:omni: Completed listmyslices:
     647
     648  Options as run:
     649                framework: pg
     650                getversionCacheName: /home/lnevers/.gcf/get_version_cache.json
     651
     652  Args: listmyslices lnevers
     653  Result Summary: Found 3 slice(s) for user 'lnevers'.
     654 
     655INFO:omni: ============================================================
     656
     657}}}
     658The {{{listmyslices}}} output shows that the user ''lnevers'' has 3 slices.  We now request to see what resources are associated with one of the slices at !PlanetLab:
     659{{{
     660$ omni.py -f pg -a plc -t geni 3 listresources lnevers-exp1
     661INFO:omni:Loading config file /home/lnevers/.gcf/omni_config
     662INFO:omni:Using control framework pg
     663INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-exp1 expires on 2012-09-19 15:52:04 UTC
     664INFO:omni:Gathering resources reserved for slice lnevers-exp1.
     665INFO:omni:Substituting AM nickname plc with URL https://www.planet-lab.org:12346, URN unspecified_AM_URN
     666INFO:omni:Listed resources on 1 out of 1 possible aggregates.
     667INFO:omni:<?xml version="1.0" ?>
     668INFO:omni:  <!-- Reserved resources for:
     669        Slice: lnevers-exp1
     670        at AM:
     671        URN: unspecified_AM_URN
     672        URL: https://www.planet-lab.org:12346
     673 -->
     674INFO:omni:  <rspec expires="2012-10-02T10:57:30Z" generated="2012-09-18T14:59:36Z" type="manifest"
     675xmlns="http://www.geni.net/resources/rspec/3" xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1"
     676xmlns:planetlab="http://www.planet-lab.org/resources/sfa/ext/planetlab/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     677xsi:schemaLocation="http://www.geni.net/resources/rspec/3 http://www.geni.net/resources/rspec/3/manifest.xsd
     678http://www.planet-lab.org/resources/sfa/ext/planetlab/1 http://www.planet-lab.org/resources/sfa/ext/planetlab/1/planetlab.xsd">   
     679
     680      <node client_id="mynode" component_id="urn:publicid:IDN+plc:bu+node+planetlab-02.bu.edu"
     681      component_manager_id="urn:publicid:IDN+plc+authority+cm"
     682      component_name="planetlab-02.bu.edu" exclusive="false" sliver_id="urn:publicid:IDN+plc:pgeni.gpolab.bbn.com+slice+lnevers-exp1-10815">       
     683            <hardware_type name="plab-pc"/>       
     684            <hardware_type name="pc"/>       
     685            <location country="unknown" latitude="42.35" longitude="-71.1"/>       
     686            <interface client_id="10815:1605" component_id="urn:publicid:IDN+plc+interface+node10815:eth0"/>       
     687            <services>           
     688                  <login authentication="ssh-keys" hostname="planetlab-02.bu.edu" port="22" username="pgenigpolabbbncom_lneversexp1"/>           
     689            </services>       
     690            <sliver_type name="plab-vserver"/>       
     691      </node>   
     692</rspec>
     693INFO:omni: ------------------------------------------------------------
     694INFO:omni: Completed listresources:
     695  Options as run:
     696                aggregate: ['plc']
     697                framework: pg
     698                getversionCacheName: /home/lnevers/.gcf/get_version_cache.json
     699                rspectype: ('geni', '3')
     700
     701  Args: listresources lnevers-exp1
     702  Result Summary: Queried resources for slice lnevers-exp1 from 1 of 1 aggregate(s).
     703 
     704INFO:omni: ============================================================
     705
     706}}}
     707
     708The results above show that the returned RSpec contains 1 node that is part of the sliver at !PlanetLab
    754709
    755710