= ProtoGENI Test Tools Evaluation =

The ProtoGENI Test Scripts are a suite of command line tools that can be used as a user interface to control ProtoGENI facilities.  Package evaluated was found at the [http://www.protogeni.net/trac/protogeni/wiki/TestScripts Test Scritps] page and
using instructions from the page a tarball was downloaded from [http://www.emulab.net/downloads/protogeni-tests.tar.gz here].

ProtoGENI Test Scripts Time frame: This evaluation took place June 3-7, 2010.

= ProtoGENI Findings =

The PGTools work is a port of the Emulab tools to ProtoGENI APIs as a backend and are found in 
the protogeni/test directory of the Emulab source distribution. and also in the Emulab OPS node.

The tutorial is very helpful and is a must for anyone starting to us these tools.  No meaningful issues were found during this evaluation.


= ProtoGENI Test Tools How-to =

'''ProtoGENI Test Scripts Hot-to'''

Must follow the very detailed setup instructions at the [http://www.protogeni.net/trac/protogeni/wiki/Tutorial#GettingReady ProtoGENI tutorial] Page.  The list below is a summary of the actions that are required setup to use PGTools. Details can be found in the  tutorial:
{{{
 1. Get an account by sending email request to testbed-ops@flux.utah.edu
 2. Join an existing project
 3. Generate SSL certificate
 4. Generate and updaload SSH keys
}}}
You are now ready to use the test tools provided for ProtoGENI.

Slice was created using this very simple three node rspec registered a slice:
{{{
lnevers@riva:~/protogeni-tests$ ./registerslice.py -n ln_slice_pgt
Got my SA credential
No such slice registered here:Creating new slice called ln_slice_pgt
New slice created: urn:publicid:IDN+emulab.net+slice+ln_slice_pgt
}}}
and created a sliver:
{{{
lnevers@riva:~/protogeni-tests$ ./createsliver.py -n ln_slice_pgt 3node.xml 
Got my SA credential
Asking for slice credential for ln_slice_pgt
Got the slice credential
Creating the Sliver ...
Created the sliver
<rspec xmlns="http://protogeni.net/resources/rspec/0.1"> 
 <node virtual_id="geni1" virtualization_type="raw" exclusive="1" component_urn="urn:publicid:IDN+emulab.net+node+pc321" component_uuid="de9ea263-773e-102b-8eb4-001143e453fe" component_manager_urn="urn:publicid:IDN+emulab.net+authority+cm" component_manager_uuid="28a10955-aa00-11dd-ad1f-001143e453fe" sliver_uuid="de9ea263-773e-102b-8eb4-001143e453fe" hostname="pc321.emulab.net" sshdport="22" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12127"> 
   <interface virtual_id="virt0" component_id="eth4"/> 
   <disk_image name="urn:publicid:IDN+emulab.net+image+emulab-ops//FEDORA8-STD"/>
 <services><login authentication="ssh-keys" hostname="pc321.emulab.net" port="22"/></services></node>
 <node virtual_id="geni2" virtualization_type="raw" exclusive="1" component_urn="urn:publicid:IDN+emulab.net+node+pc217" component_uuid="de9fca0e-773e-102b-8eb4-001143e453fe" component_manager_urn="urn:publicid:IDN+emulab.net+authority+cm" component_manager_uuid="28a10955-aa00-11dd-ad1f-001143e453fe" sliver_uuid="de9fca0e-773e-102b-8eb4-001143e453fe" hostname="pc217.emulab.net" sshdport="22" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12128"> 
   <interface virtual_id="virt0" component_id="eth2"/>
   <interface virtual_id="virt1" component_id="eth4"/>
   <disk_image name="urn:publicid:IDN+emulab.net+image+emulab-ops//FEDORA8-STD"/>
 <services><login authentication="ssh-keys" hostname="pc217.emulab.net" port="22"/></services></node>
 <node virtual_id="geni3" virtualization_type="raw" exclusive="1" component_urn="urn:publicid:IDN+emulab.net+node+pc354" component_uuid="de9dfa4f-773e-102b-8eb4-001143e453fe" component_manager_urn="urn:publicid:IDN+emulab.net+authority+cm" component_manager_uuid="28a10955-aa00-11dd-ad1f-001143e453fe" sliver_uuid="de9dfa4f-773e-102b-8eb4-001143e453fe" hostname="pc354.emulab.net" sshdport="22" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12129"> 
   <interface virtual_id="virt0" component_id="eth4"/>
   <disk_image name="urn:publicid:IDN+emulab.net+image+emulab-ops//FEDORA8-STD"/>
 <services><login authentication="ssh-keys" hostname="pc354.emulab.net" port="22"/></services></node>
 <link virtual_id="link0" link_type="VLAN" sliver_uuid="486be29b-8059-11df-ad83-001143e453fe" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12130"> 
   <interface_ref virtual_interface_id="virt0" virtual_node_id="geni1" sliver_uuid="48c1eb45-8059-11df-ad83-001143e453fe" component_urn="urn:publicid:IDN+emulab.net+interface+pc321:eth4" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12131" MAC="000423a8fc0e" IP="10.10.1.1"/> 
   <interface_ref virtual_interface_id="virt0" virtual_node_id="geni2" sliver_uuid="49372ba4-8059-11df-ad83-001143e453fe" component_urn="urn:publicid:IDN+emulab.net+interface+pc217:eth2" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12132" MAC="000423b71496" IP="10.10.2.1"/>
 </link> 
 <link virtual_id="link1" link_type="VLAN" sliver_uuid="49f0b3ea-8059-11df-ad83-001143e453fe" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12133"> 
   <interface_ref virtual_interface_id="virt1" virtual_node_id="geni2" sliver_uuid="4a815d37-8059-11df-ad83-001143e453fe" component_urn="urn:publicid:IDN+emulab.net+interface+pc217:eth4" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12134" MAC="000423b714a6" IP="10.10.1.2"/> 
   <interface_ref virtual_interface_id="virt0" virtual_node_id="geni3" sliver_uuid="4af60f64-8059-11df-ad83-001143e453fe" component_urn="urn:publicid:IDN+emulab.net+interface+pc354:eth4" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12135" MAC="000423b71e02"/>
 </link>
<!--
 <valid_until>2010-08-14T12:00:00</valid_until>
 -->
</rspec>

}}}

Checked the status for the newly created sliver:

{{{
lnevers@riva:~/protogeni-tests$ ./sliverstatus.py -n ln_slice_pgt
Got my SA credential. Looking for slice ...
Found the slice, asking for a credential ...
Got the slice credential, asking for a sliver credential ...
Got the sliver credential, asking for sliver status
{'status': 'ready', 'state': 'started', 'details': {'urn:publicid:IDN+emulab.net+sliver+12127': {'status': 'ready', 'state': 'started', 'component_urn': 'urn:publicid:IDN+emulab.net+node+pc321', 'error': ''}, 'urn:publicid:IDN+emulab.net+sliver+12129': {'status': 'ready', 'state': 'started', 'component_urn': 'urn:publicid:IDN+emulab.net+node+pc354', 'error': ''}, 'urn:publicid:IDN+emulab.net+sliver+12128': {'status': 'ready', 'state': 'started', 'component_urn': 'urn:publicid:IDN+emulab.net+node+pc217', 'error': ''}}}

}}}

Renew Slice:
{{{
$ ./renewsliver.py -n ln_slice_pgt 43200
Got my SA credential
Found the slice, asking for a credential ...
Got the slice credential, renewing the slice at the SA ...
Renewed the slice, asking for slice credential again
Got the slice credential, renewing the sliver
Sliver has been renewed until 20100801T12:36:52
}}}
Example on how to set up a tunnel between Utah and Kentucky emulab sites:
{{{
lnevers@riva:~/protogeni-tests$ ./tuntest.py -n ln_slice_pgt ukgeni utahemulab
}}}