| 1 | [[PageOutline]] |
| 2 | = Understanding the GENI AM API using Content Centric Networking = |
| 3 | |
| 4 | == Overview == |
| 5 | Understand how resources are described and reserved in GENI. Learn how to customize those resources using standard mechanisms. Use multiple tools to act on a slice and reserve resources. |
| 6 | |
| 7 | While doing this experiment, use and understand the following terms: resource specification (RSpec), sliver, and aggregate manager API (AM API) |
| 8 | |
| 9 | === What you will learn === |
| 10 | |
| 11 | At the end of this exercise, you will be able to: |
| 12 | * Use and understand the following terms: |
| 13 | - Resource Specification (aka RSpec) |
| 14 | - sliver |
| 15 | - Aggregate Manager API (AM API) |
| 16 | * Customize the resources/RSpec you reserve using standard mechanisms. You will: |
| 17 | - understand that an RSpec is an XML file that specifies resources which are reserved using the aggregate manager API (AM API) |
| 18 | - understand how to load and edit an RSpec using Flack |
| 19 | - know how to specify the image to load on a compute node |
| 20 | - know how to have software automatically loaded and run on a compute node |
| 21 | * Use the Omni command line tool to manage resource reservations |
| 22 | * Use multiple tools to act on a slice and reserve resources |
| 23 | - understand that all tools use common mechanisms to describe resources (RSpecs) and to reserve resources (the AM API) |
| 24 | |
| 25 | |
| 26 | == Experiment Topology and Setup == |
| 27 | {{{ |
| 28 | #!comment |
| 29 | <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/PortalSimpleLayer2ExampleOneAM/Graphics/vms-on-lan.png?format=raw" height="152" alt="Tutorial Setup"/> |
| 30 | }}} |
| 31 | |
| 32 | Use the Omni GENI client to reserve a topology. |
| 33 | |
| 34 | Then arrange for automatic installation and execution of software on these nodes (performing basic traffic measurement tests). |
| 35 | |
| 36 | == Background == |
| 37 | |
| 38 | [wiki:GENIEducation/SampleAssignments/UnderstandAMAPI/Background Background information] about pre-requisites, tools, resources, and where to get help. |
| 39 | |
| 40 | == Procedure == |
| 41 | {{{ |
| 42 | #!html |
| 43 | |
| 44 | |
| 45 | <table id="Table_01" height="409" border="0" cellpadding="0" cellspacing="0"> |
| 46 | <tr> |
| 47 | <td> |
| 48 | <a href="./Procedure/DesignSetup"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/design.png?format=raw" width="152" height="152" alt="Design/Setup"></a> |
| 49 | </td> |
| 50 | <td> |
| 51 | <ul> |
| 52 | <li><a href="./Procedure/DesignSetup">Part I: Design/Setup</a></li> |
| 53 | <ul> |
| 54 | <li>Step 1: Design Experiment</li> |
| 55 | <li>Step 2: Establish Management Environment</li> |
| 56 | <li>Step 3: Obtain Resources</li> |
| 57 | </ul></ul> |
| 58 | </td> |
| 59 | </tr> |
| 60 | <tr> |
| 61 | <td> |
| 62 | <a href="./Procedure/Execute"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.png?format=raw" width="152" height="143" alt="Execute"></a> |
| 63 | </td> |
| 64 | <td> |
| 65 | <ul> |
| 66 | <li><a href="./Procedure/Execute">Part II: Execute</a></li> |
| 67 | <ul> |
| 68 | <li>Step 4: Configure and Initialize Services </li> |
| 69 | <li>Step 5: Execute Experiment </li> |
| 70 | <li>Step 6: Analyze and Visualize Experiment </li> |
| 71 | </ul></ul> |
| 72 | </td> |
| 73 | </tr> |
| 74 | <tr> |
| 75 | <td> |
| 76 | <a href="./Procedure/Finish"><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.png?format=raw" width="152" height="114" alt="Finish"></a> |
| 77 | </td> |
| 78 | |
| 79 | <td> |
| 80 | <ul> |
| 81 | <li><a href="./Procedure/Finish">Part III: Finish</a></li> |
| 82 | <ul> |
| 83 | <li>Step 7: Teardown Experiment</li> |
| 84 | <li>Step 8: Archive Experiment</li> |
| 85 | </ul></ul> |
| 86 | </td> |
| 87 | |
| 88 | </tr> |
| 89 | </table> |