Changes between Version 20 and Version 21 of GENIExperimenter/ExperimentExample


Ignore:
Timestamp:
01/09/12 13:31:51 (12 years ago)
Author:
lnevers@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIExperimenter/ExperimentExample

    v20 v21  
    6868Getting a list of resources from the Emulab Protogeni aggregate in ProtoGENI RSpec V2 format:
    6969{{{
    70 $  src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am -o -t ProtoGENI 2 listresources
     70$ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am -o -t ProtoGENI 2 listresources
    7171INFO:omni:Loading config file omni_config
    7272INFO:omni:Using control framework pgeni
     
    7878
    7979  Options as run:
    80                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    81                 configfile: omni_config
    82                 framework: pgeni
    83                 native: True
    84                 output: True
    85                 rspectype: ('ProtoGENI', '2')
     80                aggregate: https://www.emulab.net/protogeni/xmlrpc/am
     81                framework: pgeni
     82                native: True
     83                output: True
     84                rspectype: ('ProtoGENI', '2')
    8685
    8786  Args: listresources
    88 
    8987  Result Summary: Retrieved resources from 1 aggregates.
    90 Wrote rspecs from 1 aggregates to 1 files.
     88Wrote rspecs from 1 aggregates to 1 files
     89Saved listResources RSpec at unspecified_AM_URN to file rspec-www-emulab-net-protogeni.xml.
    9190INFO:omni: ============================================================
    9291}}}
     
    9796<?xml version="1.0" ?>
    9897<!-- Resources at AM:
    99         URN: unspecified_AM_URN
    100         URL: https://www.emulab.net/protogeni/xmlrpc/am
     98        URN: unspecified_AM_URN
     99        URL: https://www.emulab.net/protogeni/xmlrpc/am
    101100 -->
    102 <rspec expires="2011-07-06T13:34:00Z" generated="2011-07-07T13:34:00Z" type="advertisement" xmlns="http://www.protogeni.net/resources/rspec/2" xmlns:emulab="http://www.protogeni.net/resources/rspec/ext/emulab/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.protogeni.net/resources/rspec/2 http://www.protogeni.net/resources/rspec/2/ad.xsd http://www.protogeni.net/resources/rspec/ext/emulab/1 http://www.protogeni.net/resources/rspec/ext/emulab/1/ptop_extension.xsd"> 
    103   <node component_id="urn:publicid:IDN+emulab.net+node+cisco3" component_manager
     101
     102<rspec expires="2012-01-09T17:28:17Z" generated="2012-01-09T17:28:17Z" type="advertisement" xmlns="http://www.protogeni.net/resources/rspec/2" xmlns:emulab="http://www.protogeni.net/resources/rspec/ext/emul
     103ab/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.protogeni.net/resources/rspec/2 http://www.protogeni.net/resources/rspec/2/ad.xsd http://www.protogeni.net/resource
     104s/rspec/ext/emulab/1 http://www.protogeni.net/resources/rspec/ext/emulab/1/ptop_extension.xsd http://company.com/rspec/ext/stitch/1 http://company.com/rspec/ext/stitch/1/ad.xsd "> 
    104105}}}
    105106
    106107Getting a list of resources from the !PlanetLab Princeton aggregate in its default format (SFA):
    107108{{{
    108 src/omni.py -o -a http://www.planet-lab.org:12346 listresources
     109./src/omni.py -o -a http://www.planet-lab.org:12346 -t geni 3 --api-version 2 listresources
    109110INFO:omni:Loading config file omni_config
    110111INFO:omni:Using control framework pgeni
     
    116117
    117118  Options as run:
    118                 aggregate: https://www.planet-lab.org:12346
    119                 configfile: omni_config
    120                 framework: pgeni
    121                 native: True
    122                 output: True
     119                aggregate: http://www.planet-lab.org:12346
     120                api_version: 2
     121                framework: pgeni
     122                native: True
     123                output: True
     124                rspectype: ('geni', '3')
    123125
    124126  Args: listresources
    125 
    126127  Result Summary: Retrieved resources from 1 aggregates.
    127 Wrote rspecs from 1 aggregates to 1 files.
     128Wrote rspecs from 1 aggregates to 1 files
     129Saved listResources RSpec at unspecified_AM_URN to file rspec-www-planet-lab-org.xml.
    128130INFO:omni: ============================================================
    129131}}}
     
    132134{{{
    133135#!xml
    134 <?xml version="1.0" ?>
    135136<!-- Resources at AM:
    136         URN: unspecified_AM_URN
    137         URL: https://www.planet-lab.org:12346
     137        URN: unspecified_AM_URN
     138        URL: http://www.planet-lab.org:12346
    138139 -->
    139 <RSpec expires="2011-06-16T14:37:07Z" generated="2011-06-16T13:37:07Z" type="SFA"> 
    140     <network name="plc">   
    141 }}}
    142 
     140
     141<rspec expires="2012-01-09T17:30:45Z" generated="2012-01-09T16:30:45Z" type="advertisement" xmlns="http://www.geni.net/resources/rspec/3" xmlns:flack="http://www.protogeni.net/resources/rspec/ext/flack/1" x
     142mlns:planetlab="http://www.planet-lab.org/resources/sfa/ext/planetlab/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.geni.net/resources/rspec/3 http://www.geni.net/r
     143esources/rspec/3/ad.xsd http://www.planet-lab.org/resources/sfa/ext/planetlab/1 http://www.planet-lab.org/resources/sfa/ext/planetlab/1/planetlab.xsd"> 
     144}}}
    143145
    144146You may use the output of these two ''listresources'' commands to generate rspecs to request resources. The above ''listresources'' commands use the default native rspec format rather than the deprecated omnispec format. Note that with native RSpecs, the {{{-a}}} flag or the {{{aggregates}}} entry in your {{{omni_config}}} is required to specify an aggregate manager.   
     
    146148If you are planning to use MyPLC resources, you may query a MyPLC installation to get a list of available resources as follows:
    147149{{{
    148 $ ./src/omni.py -a http://myplc.gpolab.bbn.com:12346 -o listresources
     150$  ./src/omni.py -a http://myplc.gpolab.bbn.com:12346 -o listresources
    149151INFO:omni:Loading config file omni_config
    150152INFO:omni:Using control framework pgeni
     
    156158
    157159  Options as run:
    158                 aggregate: http://myplc.gpolab.bbn.com:12346
    159                 configfile: omni_config
    160                 framework: pgeni
    161                 native: True
    162                 output: True
     160                aggregate: http://myplc.gpolab.bbn.com:12346
     161                framework: pgeni
     162                native: True
     163                output: True
    163164
    164165  Args: listresources
    165166
    166167  Result Summary: Retrieved resources from 1 aggregates.
    167 Wrote rspecs from 1 aggregates to 1 files.
     168Wrote rspecs from 1 aggregates to 1 files
     169Saved listResources RSpec at unspecified_AM_URN to file rspec-myplc-gpolab-bbn-com.xml.
    168170INFO:omni: ============================================================
    169171}}}
     
    171173If you are planning to use University of Kentucky Emulab resources, you can query just this installation (instead of all PG aggregates, as we did in the example above) to get a list of available resources. Note the example below was collected with GPO pgeni.gpolab.bbn.com credentials:
    172174{{{
    173 $ src/omni.py -a https://www.uky.emulab.net/protogeni/xmlrpc/am -o listresources
     175$  ./src/omni.py -a https://www.uky.emulab.net/protogeni/xmlrpc/am -o listresources
    174176INFO:omni:Loading config file omni_config
    175177INFO:omni:Using control framework pgeni
     
    181183
    182184  Options as run:
    183                 aggregate: https://www.uky.emulab.net/protogeni/xmlrpc/am
    184                 configfile: omni_config
    185                 framework: pgeni
    186                 native: True
    187                 output: True
     185                aggregate: https://www.uky.emulab.net/protogeni/xmlrpc/am
     186                framework: pgeni
     187                native: True
     188                output: True
    188189
    189190  Args: listresources
    190191
    191192  Result Summary: Retrieved resources from 1 aggregates.
    192 Wrote rspecs from 1 aggregates to 1 files.
     193Wrote rspecs from 1 aggregates to 1 files
     194Saved listResources RSpec at unspecified_AM_URN to file rspec-www-uky-emulab-net-protogeni.xml.
    193195INFO:omni: ============================================================
    194196}}}
     
    196198== Create a slice ==
    197199
    198 Since the [wiki:GENIExperimenter/ExperimentExample#OmniConfiguration omni_config] specifies using the credentials and the Clearinghouse for the GPO Protogeni, your slice will be created in the pgeni.gpolab.bbn.com namespace.  For this example a slice named ''lnevers_slice'' is created; you should choose a slice name that is meaningful to you. To avoid confusion, avoid creating a slice with the same name as your username (ie if your username is ''lnevers'', don't name your slice ''lnevers'' too).
    199 
    200 {{{
    201 $ ./src/omni.py createslice lnevers_slice
    202 INFO:omni:Loading config file omni_config
    203 INFO:omni:Using control framework pgeni
    204 INFO:omni:Created slice with Name lnevers_slice, URN urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice, Expiration 2011-06-16 19:46:49
     200Since the [wiki:GENIExperimenter/ExperimentExample#OmniConfiguration omni_config] specifies using the credentials and the Clearinghouse for the GPO Protogeni, your slice will be created in the pgeni.gpolab.bbn.com namespace.  For this example a slice named ''lnevers_1slice'' is created; you should choose a slice name that is meaningful to you. To avoid confusion, avoid creating a slice with the same name as your username (ie if your username is ''lnevers'', don't name your slice ''lnevers'' too).
     201
     202{{{
     203$  ./src/omni.py createslice lnevers-1slice
     204INFO:omni:Loading config file omni_config
     205INFO:omni:Using control framework pgeni
     206INFO:omni:Created slice with Name lnevers-1slice, URN urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice, Expiration 2012-01-10 00:07:45
    205207INFO:omni: ------------------------------------------------------------
    206208INFO:omni: Completed createslice:
    207209
    208210  Options as run:
    209                 configfile: omni_config
    210                 framework: pgeni
    211                 native: True
    212 
    213   Args: createslice lnevers_slice
    214 
    215   Result Summary: Created slice with Name lnevers_slice, URN urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice, Expiration 2011-06-16 19:46:49
    216  
    217 INFO:omni: ============================================================
     211                framework: pgeni
     212                native: True
     213
     214  Args: createslice lnevers-1slice
     215
     216  Result Summary: Created slice with Name lnevers-1slice, URN urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice, Expiration 2012-01-10 00:07:45
     217INFO:omni: ============================================================
     218
    218219}}}
    219220
     
    223224
    224225{{{
    225 $ ./src/omni.py renewslice lnevers_slice 20110707
    226 INFO:omni:Loading config file omni_config
    227 INFO:omni:Using control framework pgeni
    228 INFO:omni.protogeni:Requesting new slice expiration '2011-07-07T00:00:00'
    229 INFO:omni:Slice lnevers_slice now expires at 2011-07-07 00:00:00 UTC
    230 INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires within 1 day on 2011-07-07 00:00:00 UTC
     226$  ./src/omni.py renewslice lnevers-1slice 2012-01-30
     227INFO:omni:Loading config file omni_config
     228INFO:omni:Using control framework pgeni
     229INFO:omni.protogeni:Requesting new slice expiration '2012-01-30T00:00:00'
     230INFO:omni:Slice lnevers-1slice now expires at 2012-01-30 00:00:00 UTC
     231INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    231232INFO:omni: ------------------------------------------------------------
    232233INFO:omni: Completed renewslice:
     
    236237                native: True
    237238
    238   Args: renewslice lnevers_slice 20110707
    239 
    240   Result Summary: Slice lnevers_slice now expires at 2011-07-07 00:00:00 UTC
    241 Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires within 1 day(s) on 2011-07-07 00:00:00 UTC
    242 INFO:omni: ============================================================
    243 
     239  Args: renewslice lnevers-1slice 2012-01-30
     240
     241  Result Summary: Slice lnevers-1slice now expires at 2012-01-30 00:00:00 UTC
     242Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
     243INFO:omni: ============================================================
    244244}}}
    245245
     
    267267}}}
    268268
    269 To request two Protogeni nodes, a sliver was created within the Emulab Protogeni aggregate with the rspec above using the following command. Note the use of the {{{-o}}} argument, which saves the manifest RSpec to a file. The manifest contains your new host's IP address and login information.
    270 {{{
    271 $ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am -o createsliver lnevers_slice emulab.rspec
    272 INFO:omni:Loading config file omni_config
    273 INFO:omni:Using control framework pgeni
    274 INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires within 1 day on 2011-07-07 00:00:00 UTC
    275 INFO:omni:Creating sliver(s) from rspec file emulab.rspec for slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice
    276 INFO:omni:Writing result of createsliver for slice: lnevers_slice at AM: https://www.emulab.net/protogeni/xmlrpc/am to file lnevers_slice-manifest-rspec-www-emulab-net-protogeni.xml
    277 INFO:omni:Writing to 'lnevers_slice-manifest-rspec-www-emulab-net-protogeni.xml'
     269To request two Protogeni nodes, a sliver was created within the Emulab Protogeni aggregate with the RSpec above using the following command. Note the use of the {{{-o}}} argument, which saves the manifest RSpec to a file. The manifest contains your new host's IP address and login information.
     270{{{
     271$  ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am -o createsliver lnevers-1slice emulab.rspec
     272INFO:omni:Loading config file omni_config
     273INFO:omni:Using control framework pgeni
     274INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
     275INFO:omni:Creating sliver(s) from rspec file emulab.rspec for slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice
     276INFO:omni:Writing result of createsliver for slice: lnevers-1slice at AM: https://www.emulab.net/protogeni/xmlrpc/am to file lnevers-1slice-manifest-rspec-www-emulab-net-protogeni.xml
     277INFO:omni:Writing to 'lnevers-1slice-manifest-rspec-www-emulab-net-protogeni.xml'
    278278INFO:omni: ------------------------------------------------------------
    279279INFO:omni: Completed createsliver:
     
    285285                output: True
    286286
    287   Args: createsliver lnevers_slice emulab.rspec
    288 
    289   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires within 1 day(s) on 2011-07-07 00:00:00 UTC
     287  Args: createsliver lnevers-1slice emulab.rspec
     288
     289  Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    290290Reserved resources on https://www.emulab.net/protogeni/xmlrpc/am.
    291    Saved createsliver results to lnevers_slice-manifest-rspec-www-emulab-net-protogeni.xml. 
    292 INFO:omni: ============================================================
    293 }}}
    294 
    295 The manifest RSpec ''lnevers_slice-manifest-rspec-www-emulab-net-protogeni.xml''- the result of your reservation - looks like this:
     291   Saved createsliver results to lnevers-1slice-manifest-rspec-www-emulab-net-protogeni.xml. 
     292INFO:omni: ============================================================
     293}}}
     294
     295The manifest RSpec ''lnevers-1slice-manifest-rspec-www-emulab-net-protogeni.xml''- the result of your reservation - looks like this:
    296296{{{
    297297#!xml
    298 <?xml version="1.0" ?>
    299298<!-- Reserved resources for:
    300         Slice: lnevers_slice
     299        Slice: lnevers-1slice
    301300        At AM:
    302301        URL: https://www.emulab.net/protogeni/xmlrpc/am
    303302 -->
    304303
    305 <rspec type="manifest" xmlns="http://www.protogeni.net/resources/rspec/2" xmlns:emulab="http://www.protogeni.net/resources/rspec/ext/emulab/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-insta
    306 nce" xsi:schemaLocation="http://www.protogeni.net/resources/rspec/2 http://www.protogeni.net/resources/rspec/2/manifest.xsd http://www.protogeni.net/resources/rspec/ext/emulab/1 http://www.pro
    307 togeni.net/resources/rspec/ext/emulab/1/ptop_extension.xsd"> 
    308     <node client_id="geni1" component_id="urn:publicid:IDN+emulab.net+node+pc89" component_manager_id="urn:publicid:IDN+emulab.net+authority+cm" exclusive="true" sliver_id="urn:publicid:IDN+em
    309 ulab.net+sliver+42792" xmlns:emulab="http://www.protogeni.net/resources/rspec/ext/emulab/1">   
    310         <sliver_type name="raw"/>   
    311       <emulab:vnode name="pc89"/>    <services>      <login authentication="ssh-keys" hostname="pc89.emulab.net" port="22" username="lnevers"/>    </services>  </node> 
    312     <node client_id="geni2" component_id="urn:publicid:IDN+emulab.net+node+pc119" component_manager_id="urn:publicid:IDN+emulab.net+authority+cm" exclusive="true" sliver_id="urn:publicid:IDN+e
    313 mulab.net+sliver+42793" xmlns:emulab="http://www.protogeni.net/resources/rspec/ext/emulab/1">   
    314         <sliver_type name="raw"/>   
    315       <emulab:vnode name="pc119"/>    <services>      <login authentication="ssh-keys" hostname="pc119.emulab.net" port="22" username="lnevers"/>    </services>  </node> 
     304<rspec type="manifest" xmlns="http://www.protogeni.net/resources/rspec/2" xmlns:emulab="http://www.protogeni.net/resources/rspec/ext/emulab/1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schem
     305aLocation="http://www.protogeni.net/resources/rspec/2 http://www.protogeni.net/ resources/rspec/2/request.xsd http://www.protogeni.net/resources/rspec/ext/emulab/1 http://www.protogeni.net/resources/rspec/e
     306xt/emulab/1/ptop _extension.xsd"> 
     307    <node component_id="urn:publicid:IDN+emulab.net+node+pc333" component_manager_id="urn:publicid:IDN+emulab.net+authority+cm" exclusive="true" sliver_id="urn:publicid:IDN+emulab.net+sliver+68392" virtual_id="geni1" virtualization_type="emulab-vnode" xmlns:emulab="http://www.protogeni.net/resources/rspec/ext/emulab/1">   
     308      <sliver_type name="raw-pc"/>    <emulab:vnode name="pc333"/>    <host name="geni1.lnevers-1slice.pgeni-gpolab-bbn-com.emulab.net"/>    <services>      <login authentication="ssh-keys" hostname="pc333.
     309emulab.net" port="22" username="lnevers"/>    </services>  </node> 
     310    <node component_id="urn:publicid:IDN+emulab.net+node+pc350" component_manager_id="urn:publicid:IDN+emulab.net+authority+cm" exclusive="true" sliver_id="urn:publicid:IDN+emulab.net+sliver+68393" virtual_id="geni2" virtualization_type="emulab-vnode" xmlns:emulab="http://www.protogeni.net/resources/rspec/ext/emulab/1">   
     311      <sliver_type name="raw-pc"/>    <emulab:vnode name="pc350"/>    <host name="geni2.lnevers-1slice.pgeni-gpolab-bbn-com.emulab.net"/>    <services>      <login authentication="ssh-keys" hostname="pc350.
     312emulab.net" port="22" username="lnevers"/>    </services>  </node> 
    316313</rspec>
    317314}}}
     
    380377
    381378{{{
    382 $ ./src/omni.py -a http://www.planet-lab.org:12346 -o createsliver lnevers_slice planet.rspec
    383 INFO:omni:Loading config file omni_config
    384 INFO:omni:Using control framework pgeni
    385 INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires within 1 day on 2011-07-07 00:00:00 UTC
    386 INFO:omni:Creating sliver(s) from rspec file planet.rspec for slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice
    387 INFO:omni:Writing result of createsliver for slice: lnevers_slice at AM: http://www.planet-lab.org:12346 to file lnevers_slice-manifest-rspec-www-planet-lab-org.xml
    388 INFO:omni:Writing to 'lnevers_slice-manifest-rspec-www-planet-lab-org.xml'
     379$  ./src/omni.py -a http://www.planet-lab.org:12346 -o createsliver --api-version 2  lnevers-1slice planet.rspec
     380INFO:omni:Loading config file omni_config
     381INFO:omni:Using control framework pgeni
     382INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
     383INFO:omni:Creating sliver(s) from rspec file planet.rspec for slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice
     384INFO: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
     385INFO:omni:Writing to 'lnevers-1slice-manifest-rspec-www-planet-lab-org.xml'
    389386INFO:omni: ------------------------------------------------------------
    390387INFO:omni: Completed createsliver:
     
    392389  Options as run:
    393390                aggregate: http://www.planet-lab.org:12346
     391                api_version: 2
    394392                framework: pgeni
    395393                native: True
    396394                output: True
    397395
    398   Args: createsliver lnevers_slice planet.rspec
    399 
    400   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires within 1 day(s) on 2011-07-07 00:00:00 UTC
     396  Args: createsliver lnevers-1slice planet.rspec
     397
     398  Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    401399Reserved resources on http://www.planet-lab.org:12346.
    402    Saved createsliver results to lnevers_slice-manifest-rspec-www-planet-lab-org.xml. 
    403 INFO:omni: ============================================================
    404 
    405 }}}
    406 
    407 The resulting manifest RSpec ''lnevers_slice-manifest-rspec-www-planet-lab-org.xml'' is this:
     400   Saved createsliver results to lnevers-1slice-manifest-rspec-www-planet-lab-org.xml. 
     401INFO:omni: ============================================================
     402}}}
     403
     404The resulting manifest RSpec ''lnevers-1slice-manifest-rspec-www-planet-lab-org.xml'' is this:
    408405{{{
    409406#!xml
    410407<?xml version="1.0" ?>
    411408<!-- Reserved resources for:
    412         Slice: lnevers_slice
     409        Slice: lnevers-1slice
    413410        At AM:
    414411        URL: http://www.planet-lab.org:12346
    415412 -->
    416 
    417 <rspec expires="2011-07-06T15:32:16Z" generated="2011-07-06T14:32:16Z" type="manifest" xmlns="http://www.protogeni.net/resources/rspec/2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    418 xsi:schemaLocation="http://www.protogeni.net/resources/rspec/2 http://www.protogeni.net/resources/rspec/2/manifest.xsd"> 
    419     <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+am" component_name=
    420 "planetlab3.williams.edu" exclusive="false" sliver_id="urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice">   
     413<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
     414mlns: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
     415geni.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"> 
     416    <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
     417.bbn.com" exclusive="false" sliver_id="urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:23324:13627:0">   
    421418        <hardware_type name="plab-pc"/>   
    422419        <hardware_type name="pc"/>   
    423         <sliver_type name="plab-vnode"/>   
    424         <location country="us" latitude="42.71" longitude="-73.2"/>   
     420        <location country="unknown" latitude="42.3907" longitude="-71.1478"/>   
     421        <interface client_id="13627:2918" component_id="urn:publicid:IDN+plc+interface+node13627:eth0"/>   
     422        <services>     
     423            <login authentication="ssh-keys" hostname="plnode-03.gpolab.bbn.com" port="22" username="pgenigpolabbbncom_lnevers1slice"/>     
     424        </services>   
     425        <sliver_type name="plab-vserver"/>   
    425426    </node> 
    426     <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+am" component_name="pl
    427 node-03.gpolab.bbn.com" exclusive="false" sliver_id="urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice">   
     427    <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
     428lliams.edu" exclusive="false" sliver_id="urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:23324:10860:0">   
    428429        <hardware_type name="plab-pc"/>   
    429430        <hardware_type name="pc"/>   
    430         <sliver_type name="plab-vnode"/>   
    431         <location country="us" latitude="42.3907" longitude="-71.1478"/>   
     431        <location country="unknown" latitude="42.71" longitude="-73.2"/>   
     432        <interface client_id="10860:1643" component_id="urn:publicid:IDN+plc+interface+node10860:eth0"/>   
     433        <services>     
     434            <login authentication="ssh-keys" hostname="planetlab3.williams.edu" port="22" username="pgenigpolabbbncom_lnevers1slice"/>     
     435        </services>   
     436        <sliver_type name="plab-vserver"/>   
    432437    </node> 
    433     <node client_id="planet2.cs.rit.edu" component_id="urn:publicid:IDN+plc:rit+node+planet2.cs.rit.edu" component_manager_id="urn:publicid:IDN+plc+authority+am" component_name="planet2.cs.rit
    434 .edu" exclusive="false" sliver_id="urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice">   
     438</rspec>
     439}}}
     440
     441Note that your login for your nodes is available by running {{{sliverstatus}}}.
     442
     443As 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].
     444
     445== Checking sliver resource status ==
     446
     447Once you have requested the resources you may check the sliver status for PG and PL nodes. As you review the results, note the expiration time to make sure that it meets your experiment running time requirement. To get ''sliverstatus'' for the example experiment on this page the following command was issued for the PG resources:
     448
     449{{{
     450<?xml version="1.0" ?>
     451<!-- Reserved resources for:
     452        Slice: lnevers-1slice
     453        At AM:
     454        URL: http://www.planet-lab.org:12346
     455 -->
     456
     457<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
     458mlns: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
     459geni.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"> 
     460    <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
     461.bbn.com" exclusive="false" sliver_id="urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:23324:13627:0">   
    435462        <hardware_type name="plab-pc"/>   
    436463        <hardware_type name="pc"/>   
    437         <sliver_type name="plab-vnode"/>   
    438         <location country="us" latitude="43.0844" longitude="-77.6799"/>   
    439     </node> 
    440 </rspec>
    441 
    442 }}}
    443 
    444 Note that your login for your nodes is available by running {{{sliverstatus}}}.
    445 
    446 As 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].
    447 
    448 == Checking sliver resource status ==
    449 
    450 Once you have requested the resources you may check the sliver status for PG and PL nodes. As you review the results, note the expiration time to make sure that it meets your experiment running time requirement. To get ''sliverstatus'' for the example experiment on this page the following command was issued for the PG resources:
    451 
    452 {{{
    453 $ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am sliverstatus lnevers_slice
    454 INFO:omni:Loading config file omni_config
    455 INFO:omni:Using control framework pgeni
    456 INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires on 2011-07-07 00:00:00 UTC
    457 INFO:omni:Status of Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice:
    458 INFO:omni:Sliver status for Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice at AM URL https://www.emulab.net/protogeni/xmlrpc/am
     464        <location country="unknown" latitude="42.3907" longitude="-71.1478"/>   
     465        <interface client_id="13627:2918" component_id="urn:publicid:IDN+plc+interface+node13627:eth0"/>   
     466        <services>     
     467            <login authentication="ssh-keys" hostname="plnode-03.gpolab.bbn.com" port="22" username="pgenigpolabbbncom_lnevers1slice"/>     
     468        </services>   
     469lnevers@sendaria:~/gcf-1.5.1$ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am sliverstatus lnevers-1slice
     470INFO:omni:Loading config file omni_config
     471INFO:omni:Using control framework pgeni
     472INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
     473INFO:omni:Status of Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:
     474INFO: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
    459475INFO:omni:{'geni_resources': [{'geni_error': '',
    460476                     'geni_status': 'ready',
    461                      'geni_urn': 'urn:publicid:IDN+emulab.net+sliver+39860',
    462                      'pg_manifest': {'attributes': {'client_id': 'geni1',
    463                                                     'component_id': 'urn:publicid:IDN+emulab.net+node+pc141',
     477                     'geni_urn': 'urn:publicid:IDN+emulab.net+sliver+68392',
     478                     'pg_manifest': {'attributes': {'component_id': 'urn:publicid:IDN+emulab.net+node+pc333',
    464479                                                    'component_manager_id': 'urn:publicid:IDN+emulab.net+authority+cm',
    465480                                                    'exclusive': 'true',
    466                                                     'sliver_id': 'urn:publicid:IDN+emulab.net+sliver+39860',
     481                                                    'sliver_id': 'urn:publicid:IDN+emulab.net+sliver+68392',
     482                                                    'virtual_id': 'geni1',
     483                                                    'virtualization_type': 'emulab-vnode',
    467484                                                    'xmlns': 'http://www.protogeni.net/resources/rspec/2',
    468485                                                    'xmlns:emulab': 'http://www.protogeni.net/resources/rspec/ext/emulab/1'},
    469                                      'children': [{'attributes': {'name': 'raw'},
     486                                     'children': [{'attributes': {'name': 'raw-pc'},
    470487                                                   'children': [],
    471488                                                   'name': 'sliver_type'},
    472                                                   {'attributes': {'name': 'pc141'},
     489                                                  {'attributes': {'name': 'pc333'},
    473490                                                   'children': [],
    474491                                                   'name': 'emulab:vnode'},
     492                                                  {'attributes': {'name': 'geni1.lnevers-1slice.pgeni-gpolab-bbn-com.emulab.net'},
     493                                                   'children': [],
     494                                                   'name': 'host'},
    475495                                                  {'attributes': {},
    476496                                                   'children': [{'attributes': {'authentication': 'ssh-keys',
    477                                                                                 'hostname': 'pc141.emulab.net',
     497                                                                                'hostname': 'pc333.emulab.net',
    478498                                                                                'port': 22,
    479499                                                                                'username': 'lnevers'},
     
    485505                    {'geni_error': '',
    486506                     'geni_status': 'ready',
    487                      'geni_urn': 'urn:publicid:IDN+emulab.net+sliver+39861',
    488                      'pg_manifest': {'attributes': {'client_id': 'geni2',
    489                                                     'component_id': 'urn:publicid:IDN+emulab.net+node+pc139',
     507                     'geni_urn': 'urn:publicid:IDN+emulab.net+sliver+68393',
     508                     'pg_manifest': {'attributes': {'component_id': 'urn:publicid:IDN+emulab.net+node+pc350',
    490509                                                    'component_manager_id': 'urn:publicid:IDN+emulab.net+authority+cm',
    491510                                                    'exclusive': 'true',
    492                                                     'sliver_id': 'urn:publicid:IDN+emulab.net+sliver+39861',
     511                                                    'sliver_id': 'urn:publicid:IDN+emulab.net+sliver+68393',
     512                                                    'virtual_id': 'geni2',
     513                                                    'virtualization_type': 'emulab-vnode',
    493514                                                    'xmlns': 'http://www.protogeni.net/resources/rspec/2',
    494515                                                    'xmlns:emulab': 'http://www.protogeni.net/resources/rspec/ext/emulab/1'},
    495                                      'children': [{'attributes': {'name': 'raw'},
     516                                     'children': [{'attributes': {'name': 'raw-pc'},
    496517                                                   'children': [],
    497518                                                   'name': 'sliver_type'},
    498                                                   {'attributes': {'name': 'pc139'},
     519                                                  {'attributes': {'name': 'pc350'},
    499520                                                   'children': [],
    500521                                                   'name': 'emulab:vnode'},
     522                                                  {'attributes': {'name': 'geni2.lnevers-1slice.pgeni-gpolab-bbn-com.emulab.net'},
     523                                                   'children': [],
     524                                                   'name': 'host'},
    501525                                                  {'attributes': {},
    502526                                                   'children': [{'attributes': {'authentication': 'ssh-keys',
    503                                                                                 'hostname': 'pc139.emulab.net',
     527                                                                                'hostname': 'pc350.emulab.net',
    504528                                                                                'port': 22,
    505529                                                                                'username': 'lnevers'},
     
    510534                     'pg_status': 'ready'}],
    511535 'geni_status': 'ready',
    512  'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice',
    513  'pg_expires': '2011-07-07 18:00:00',
     536 'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice',
     537 'pg_expires': '2012-01-14 11:10:10',
    514538 'pg_status': 'ready'}
    515539INFO:omni: ------------------------------------------------------------
     
    517541
    518542  Options as run:
    519                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    520                 configfile: omni_config
    521                 framework: pgeni
    522                 native: True
    523 
    524   Args: sliverstatus ahtest_slice
    525 
    526   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires on 2011-07-07 00:00:00 UTC
     543                aggregate: https://www.emulab.net/protogeni/xmlrpc/am
     544                framework: pgeni
     545                native: True
     546
     547  Args: sliverstatus lnevers-1slice
     548
     549  Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    527550Returned status of slivers on 1 of 1 possible aggregates.
    528551INFO:omni: ============================================================
     
    532555
    533556{{{
    534 $ ./src/omni.py -a http://www.planet-lab.org:12346 -o sliverstatus lnevers_slice
    535 INFO:omni:Loading config file omni_config
    536 INFO:omni:Using control framework pgeni
    537 INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires on 2011-07-10 00:00:00 UTC
    538 INFO:omni:Status of Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice:
    539 INFO:omni:Writing to 'lnevers_slice-sliverstatus-www-planet-lab-org.json'
    540 INFO:omni:Sliver status for Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice at AM URL http://www.planet-lab.org:12346
     557$ ./src/omni.py -a http://www.planet-lab.org:12346 -o sliverstatus -t geni 3 --api-version 2 lnevers-1slice
     558INFO:omni:Loading config file omni_config
     559INFO:omni:Using control framework pgeni
     560INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
     561INFO:omni:Status of Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice:
     562INFO:omni:Writing to 'lnevers-1slice-sliverstatus-www-planet-lab-org.json'
     563INFO:omni:Sliver status for Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice at AM URL http://www.planet-lab.org:12346
    541564INFO:omni: ------------------------------------------------------------
    542565INFO:omni: Completed sliverstatus:
     
    544567  Options as run:
    545568                aggregate: http://www.planet-lab.org:12346
     569                api_version: 2
    546570                framework: pgeni
    547571                native: True
    548572                output: True
    549 
    550   Args: sliverstatus lnevers_slice
    551 
    552   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires on 2011-07-10 00:00:00 UTC
     573                rspectype: ('geni', '3')
     574
     575  Args: sliverstatus lnevers-1slice
     576
     577  Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
     578Saved sliverstatus on lnevers-1slice at AM http://www.planet-lab.org:12346 to file lnevers-1slice-sliverstatus-www-planet-lab-org.json.
    553579Returned status of slivers on 1 of 1 possible aggregates.
    554580INFO:omni: ============================================================
     
    559585{'geni_resources': [{'geni_error': '',
    560586                     'geni_status': 'ready',
    561                      'geni_urn': 'urn:publicid:IDN+plc:williams+node+planetlab3.williams.edu',
     587                     'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+lnevers-1slice:23324:13627:0',
     588                     'pl_boot_state': 'boot',
     589                     'pl_hostname': 'plnode-03.gpolab.bbn.com',
     590                     'pl_last_contact': '2012-01-09T13:15:59Z'},
     591                    {'geni_error': '',
     592                     'geni_status': 'ready',
     593                     'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+lnevers-1slice:23324:10860:0',
    562594                     'pl_boot_state': 'boot',
    563595                     'pl_hostname': 'planetlab3.williams.edu',
    564                      'pl_last_contact': 'Wed Jul  6 10:56:20 2011'},
    565                     {'geni_error': '',
    566                      'geni_status': 'ready',
    567                      'geni_urn': 'urn:publicid:IDN+plc:rit+node+planet2.cs.rit.edu',
    568                      'pl_boot_state': 'boot',
    569                      'pl_hostname': 'planet2.cs.rit.edu',
    570                      'pl_last_contact': 'Wed Jul  6 10:51:47 2011'},
    571                     {'geni_error': '',
    572                      'geni_status': 'ready',
    573                      'geni_urn': 'urn:publicid:IDN+plc:bbn+node+plnode-03.gpolab.bbn.com',
    574                      'pl_boot_state': 'boot',
    575                      'pl_hostname': 'plnode-03.gpolab.bbn.com',
    576                      'pl_last_contact': 'Wed Jul  6 10:56:02 2011'}],
     596                     'pl_last_contact': '2012-01-09T13:13:23Z'}],
    577597 'geni_status': 'ready',
    578  'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice',
    579  'pl_expires': 'Wed Jul 20 10:32:15 2011',
    580  'pl_login': 'pgenigpolabbbncom_lnevers_slice'}
     598 'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+lnevers-1slice',
     599 'pl_expires': '2012-01-23T13:12:32Z',
     600 'pl_login': 'pgenigpolabbbncom_lnevers1slice'}
    581601}}}
    582602
     
    586606Also 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.
    587607
    588 For this example the pg_expires is ''2011-06-17 18:00:00'' while the pl_expires is ''Thu Jun 30 10:52:22 2011''. 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 ''renewslice'' to expand the time for your slice as described above. Then use ''renewsliver'' to extend each sliver. The following command is issued to modify the expiration time for the ProtoGENI resources:
    589 
    590 {{{
    591 $ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am renewsliver lnevers_slice 20110618
    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_slice expires on 2011-06-18 00:00:00 UTC
    595 INFO:omni:Renewing Sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice until 2011-06-18 00:00:00 UTC
    596 INFO:omni:Renewed sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice at unspecified_AM_URN (https://www.emulab.net/protogeni/xmlrpc/am) until 2011-06-18T00:00:00 UTC
     608For 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 ''renewslice'' to expand the time for your slice as described above. Then use ''renewsliver'' to extend each sliver. The following command is issued to modify the expiration time for the ProtoGENI resources:
     609
     610{{{
     611$ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am renewsliver lnevers-1slice '2012-01-14 16:10:10'
     612INFO:omni:Loading config file omni_config
     613INFO:omni:Using control framework pgeni
     614INFO:omni:Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
     615INFO:omni:Renewing Sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice until 2012-01-14 16:10:10+00:00 (UTC)
     616INFO: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)
    597617INFO:omni: ------------------------------------------------------------
    598618INFO:omni: Completed renewsliver:
    599619
    600620  Options as run:
    601                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    602                 configfile: omni_config
    603                 framework: pgeni
    604                 native: True
    605 
    606   Args: renewsliver lnevers_slice 20110618
    607 
    608   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires on 2011-06-18 00:00:00 UTC
    609 Renewed sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice at unspecified_AM_URN (https://www.emulab.net/protogeni/xmlrpc/am) until 2011-06-18T00:00:00 UTC
    610  
     621                aggregate: https://www.emulab.net/protogeni/xmlrpc/am
     622                framework: pgeni
     623                native: True
     624
     625  Args: renewsliver lnevers-1slice 2012-01-14 16:10:10
     626
     627  Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
     628Renewed 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)
    611629INFO:omni: ============================================================
    612630}}}
     
    615633
    616634{{{
    617 $ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am sliverstatus lnevers_slice
     635$ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am sliverstatus lnevers-1slice
    618636INFO:omni:Loading config file omni_config
    619637INFO:omni:Using control framework pgeni
    620638
    621639.....
    622 
    623640 'geni_status': 'ready',
    624  'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice',
    625  'pg_expires': '2011-06-17 18:00:00',
     641 'geni_urn': 'urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice',
     642 'pg_expires': '2012-01-14 09:10:10',
    626643 'pg_status': 'ready'}
    627644INFO:omni: ------------------------------------------------------------
     
    629646
    630647  Options as run:
    631                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    632                 configfile: omni_config
    633                 framework: pgeni
    634                 native: True
    635 
    636   Args: sliverstatus lnevers_slice
    637 
    638   Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice expires on 2011-06-18 00:00:00 UTC
     648                aggregate: https://www.emulab.net/protogeni/xmlrpc/am
     649                framework: pgeni
     650                native: True
     651
     652  Args: sliverstatus lnevers-1slice
     653
     654  Result Summary: Slice urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice expires on 2012-01-30 00:00:00 UTC
    639655Returned status of slivers on 1 of 1 possible aggregates.
    640656INFO:omni: ============================================================
     
    646662Run:
    647663{{{
    648 $ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am -o -t ProtoGENI 2 listresources lnevers_slice
     664$ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am -o -t ProtoGENI 2 listresources lnevers-1slice
    649665INFO:omni:Loading config file omni_config
    650666INFO:omni:Using control framework pgeni
    651667INFO:omni:Saving output to a file.
    652 INFO:omni:Gathering resources reserved for slice lnevers_slice..
     668INFO:omni:Gathering resources reserved for slice lnevers-1slice.
    653669INFO:omni:Listed resources on 1 out of 1 possible aggregates.
    654 INFO:omni:Writing to 'lnevers_slice-rspec-www-emulab-net.xml'
     670INFO:omni:Writing to 'lnevers-1slice-rspec-www-emulab-net-protogeni.xml'
    655671INFO:omni: ------------------------------------------------------------
    656672INFO:omni: Completed listresources:
    657673
    658674  Options as run:
    659                 aggregate: http://www.emulab.net/protogeni/xmlrpc/am
    660                 native: True
    661                 output: True
    662 
    663   Args: listresources ahtest
    664 
    665   Result Summary: Retrieved resources for slice lnevers_slice from 1 aggregates.
    666 Wrote rspecs from 1 aggregates to 1 files.
    667 INFO:omni: ============================================================
    668 }}}
    669 
    670 The result will be a file (''lnevers_slice-rspec-www-emulab-net.xml'') of the resources in your slice at that aggregate.
     675                aggregate: https://www.emulab.net/protogeni/xmlrpc/am
     676                framework: pgeni
     677                native: True
     678                output: True
     679                rspectype: ('ProtoGENI', '2')
     680
     681  Args: listresources lnevers-1slice
     682
     683  Result Summary: Retrieved resources for slice lnevers-1slice from 1 aggregates.
     684Wrote rspecs from 1 aggregates to 1 files
     685Saved listResources RSpec at unspecified_AM_URN to file lnevers-1slice-rspec-www-emulab-net-protogeni.xml. 
     686INFO:omni: ============================================================
     687
     688}}}
     689
     690The result will be a file (''lnevers-1slice-rspec-www-emulab-net.xml'') of the resources in your slice at that aggregate.
    671691
    672692== Verify Resources and run your Experiment ==
     
    695715When 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:
    696716{{{
    697 $ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am deletesliver lnevers_slice
    698 INFO:omni:Loading config file omni_config
    699 INFO:omni:Using control framework pgeni
    700 INFO:omni:Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice on unspecified_AM_URN at https://www.emulab.net/protogeni/xmlrpc/am
     717$ ./src/omni.py -a https://www.emulab.net/protogeni/xmlrpc/am deletesliver lnevers-1slice
     718INFO:omni:Loading config file omni_config
     719INFO:omni:Using control framework pgeni
     720INFO: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
    701721INFO:omni: ------------------------------------------------------------
    702722INFO:omni: Completed deletesliver:
    703723
    704724  Options as run:
    705                 aggregate: https://www.emulab.net/protogeni/xmlrpc/am
    706                 configfile: omni_config
    707                 framework: pgeni
    708                 native: True
    709 
    710   Args: deletesliver lnevers_slice
    711 
    712   Result Summary: Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice on unspecified_AM_URN at https://www.emulab.net/protogeni/xmlrpc/am
     725                aggregate: https://www.emulab.net/protogeni/xmlrpc/am
     726                framework: pgeni
     727                native: True
     728
     729  Args: deletesliver lnevers-1slice
     730
     731  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
    713732INFO:omni: ============================================================
    714733}}}
     
    716735Also the Planetlab sliver was deleted as follows:
    717736{{{
    718 $ ./src/omni.py -a http://www.planet-lab.org:12346 deletesliver lnevers_slice
    719 INFO:omni:Loading config file omni_config
    720 INFO:omni:Using control framework pgeni
    721 INFO:omni:Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice on unspecified_AM_URN at https://www.planet-lab.org:12346
    722 INFO:omni: ------------------------------------------------------------
    723 INFO:omni: Completed deletesliver:
    724 
    725   Options as run:
    726                 aggregate: https://www.planet-lab.org:12346
    727                 configfile: omni_config
    728                 framework: pgeni
    729                 native: True
    730 
    731   Args: deletesliver lnevers_slice
    732 
    733   Result Summary: Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice on unspecified_AM_URN at https://www.planet-lab.org:12346
    734 INFO:omni: ============================================================
     737
    735738}}}
    736739
     
    742745For example:
    743746{{{
    744 $ ./src/omni.py listmyslices lnevers
    745 INFO:omni:Loading config file omni_config
    746 INFO:omni:Using control framework pgeni
    747 INFO:omni:User 'lnevers' has slices:
    748         urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers_slice
    749 INFO:omni: ------------------------------------------------------------
    750 INFO:omni: Completed listmyslices:
    751 
    752   Options as run:
    753                 configfile: omni_config
    754                 framework: pgeni
    755                 native: True
    756 
    757   Args: listmyslices lnevers
    758 
    759   Result Summary: Found 1 slices for user 'lnevers'.
    760  
     747$ ./src/omni.py -a http://www.planet-lab.org:12346 deletesliver  -t geni 3 --api-version 2 lnevers-1slice
     748INFO:omni:Loading config file omni_config
     749INFO:omni:Using control framework pgeni
     750INFO:omni:Deleted sliver urn:publicid:IDN+pgeni.gpolab.bbn.com+slice+lnevers-1slice on unspecified_AM_URN at http://www.planet-lab.org:12346
     751INFO:omni: ------------------------------------------------------------
     752INFO:omni: Completed deletesliver:
     753
     754  Options as run:
     755                aggregate: http://www.planet-lab.org:12346
     756                api_version: 2
     757                framework: pgeni
     758                native: True
     759                rspectype: ('geni', '3')
     760
     761  Args: deletesliver lnevers-1slice
     762
     763  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
    761764INFO:omni: ============================================================
    762765}}}
     
    764767Then, to see what resources you have in this slice at Planetlab:
    765768{{{
    766 $ ./src/omni.py -f pgeni -a http://www.planet-lab.org:12346 -t Protogeni 2 listresources lnevers_slice
    767 INFO:omni:Loading config file omni_config
    768 INFO:omni:Using control framework pgeni
    769 INFO:omni:Gathering resources reserved for slice lnevers_slice..
    770 INFO:omni:Listed resources on 1 out of 1 possible aggregates.
    771 INFO:omni:<?xml version="1.0" ?>
    772 INFO:omni:<!-- Resources for:
    773         Slice: lnevers_slice
    774         at AM:
    775         URN: unspecified_AM_URN
    776         URL: http://www.planet-lab.org:12346
    777  -->
    778 INFO:omni:<rspec expires="2011-06-16T16:31:00Z" generated="2011-06-16T15:31:00Z" type="manifest" xmlns="http://www.protogeni.net/resources/rspec/2" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.protogeni.net/resources/rspec/2 http://www.protogeni.net/resources/rspec/2/manifest.xsd"/>
    779 INFO:omni: ------------------------------------------------------------
    780 INFO:omni: Completed listresources:
    781 
    782   Options as run:
    783                 aggregate: http://www.planet-lab.org:12346
    784                 configfile: omni_config
    785                 framework: pgeni
    786                 native: True
    787                 rspectype: ('Protogeni', '2')
    788 
    789   Args: listresources lnevers_slice
    790 
    791   Result Summary: Retrieved resources for slice lnevers_slice from 1 aggregates.
    792 Wrote rspecs from 1 aggregates.
    793 INFO:omni: ============================================================
     769$ ./src/omni.py -f pgeni -a http://www.planet-lab.org:12346 -t geni 3 --api-version 2 listresources lnevers-1slice
    794770}}}
    795771
    796772The results above show that the returned RSpec contains no nodes - as expected, since we had already deleted our sliver there.
    797 
    798773
    799774