| 1 | = ProtoGENI Test Tools Evaluation = |
| 2 | |
| 3 | 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 |
| 4 | using instructions from the page a tarball was downloaded from [http://www.emulab.net/downloads/protogeni-tests.tar.gz here]. |
| 5 | |
| 6 | ProtoGENI Test Scripts Time frame: This evaluation took place June 3-7, 2010. |
| 7 | |
| 8 | = ProtoGENI Findings = |
| 9 | |
| 10 | The PGTools work is a port of the Emulab tools to ProtoGENI APIs as a backend and are found in |
| 11 | the protogeni/test directory of the Emulab source distribution. and also in the Emulab OPS node. |
| 12 | |
| 13 | The tutorial is very helpful and is a must for anyone starting to us these tools. No meaningful issues were found during this evaluation. |
| 14 | |
| 15 | |
| 16 | = ProtoGENI Test Tools How-to = |
| 17 | |
| 18 | '''ProtoGENI Test Scripts Hot-to''' |
| 19 | |
| 20 | 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: |
| 21 | {{{ |
| 22 | 1. Get an account by sending email request to testbed-ops@flux.utah.edu |
| 23 | 2. Join an existing project |
| 24 | 3. Generate SSL certificate |
| 25 | 4. Generate and updaload SSH keys |
| 26 | }}} |
| 27 | You are now ready to use the test tools provided for ProtoGENI. |
| 28 | |
| 29 | Slice was created using this very simple three node rspec registered a slice: |
| 30 | {{{ |
| 31 | lnevers@riva:~/protogeni-tests$ ./registerslice.py -n ln_slice_pgt |
| 32 | Got my SA credential |
| 33 | No such slice registered here:Creating new slice called ln_slice_pgt |
| 34 | New slice created: urn:publicid:IDN+emulab.net+slice+ln_slice_pgt |
| 35 | }}} |
| 36 | and created a sliver: |
| 37 | {{{ |
| 38 | lnevers@riva:~/protogeni-tests$ ./createsliver.py -n ln_slice_pgt 3node.xml |
| 39 | Got my SA credential |
| 40 | Asking for slice credential for ln_slice_pgt |
| 41 | Got the slice credential |
| 42 | Creating the Sliver ... |
| 43 | Created the sliver |
| 44 | <rspec xmlns="http://protogeni.net/resources/rspec/0.1"> |
| 45 | <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"> |
| 46 | <interface virtual_id="virt0" component_id="eth4"/> |
| 47 | <disk_image name="urn:publicid:IDN+emulab.net+image+emulab-ops//FEDORA8-STD"/> |
| 48 | <services><login authentication="ssh-keys" hostname="pc321.emulab.net" port="22"/></services></node> |
| 49 | <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"> |
| 50 | <interface virtual_id="virt0" component_id="eth2"/> |
| 51 | <interface virtual_id="virt1" component_id="eth4"/> |
| 52 | <disk_image name="urn:publicid:IDN+emulab.net+image+emulab-ops//FEDORA8-STD"/> |
| 53 | <services><login authentication="ssh-keys" hostname="pc217.emulab.net" port="22"/></services></node> |
| 54 | <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"> |
| 55 | <interface virtual_id="virt0" component_id="eth4"/> |
| 56 | <disk_image name="urn:publicid:IDN+emulab.net+image+emulab-ops//FEDORA8-STD"/> |
| 57 | <services><login authentication="ssh-keys" hostname="pc354.emulab.net" port="22"/></services></node> |
| 58 | <link virtual_id="link0" link_type="VLAN" sliver_uuid="486be29b-8059-11df-ad83-001143e453fe" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12130"> |
| 59 | <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"/> |
| 60 | <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"/> |
| 61 | </link> |
| 62 | <link virtual_id="link1" link_type="VLAN" sliver_uuid="49f0b3ea-8059-11df-ad83-001143e453fe" sliver_urn="urn:publicid:IDN+emulab.net+sliver+12133"> |
| 63 | <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"/> |
| 64 | <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"/> |
| 65 | </link> |
| 66 | <!-- |
| 67 | <valid_until>2010-08-14T12:00:00</valid_until> |
| 68 | --> |
| 69 | </rspec> |
| 70 | |
| 71 | }}} |
| 72 | |
| 73 | Checked the status for the newly created sliver: |
| 74 | |
| 75 | {{{ |
| 76 | lnevers@riva:~/protogeni-tests$ ./sliverstatus.py -n ln_slice_pgt |
| 77 | Got my SA credential. Looking for slice ... |
| 78 | Found the slice, asking for a credential ... |
| 79 | Got the slice credential, asking for a sliver credential ... |
| 80 | Got the sliver credential, asking for sliver status |
| 81 | {'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': ''}}} |
| 82 | |
| 83 | }}} |
| 84 | |
| 85 | Renew Slice: |
| 86 | {{{ |
| 87 | $ ./renewsliver.py -n ln_slice_pgt 43200 |
| 88 | Got my SA credential |
| 89 | Found the slice, asking for a credential ... |
| 90 | Got the slice credential, renewing the slice at the SA ... |
| 91 | Renewed the slice, asking for slice credential again |
| 92 | Got the slice credential, renewing the sliver |
| 93 | Sliver has been renewed until 20100801T12:36:52 |
| 94 | }}} |
| 95 | Example on how to set up a tunnel between Utah and Kentucky emulab sites: |
| 96 | {{{ |
| 97 | lnevers@riva:~/protogeni-tests$ ./tuntest.py -n ln_slice_pgt ukgeni utahemulab |
| 98 | }}} |