| 45 | {{{ |
| 46 | #!html |
| 47 | <table border="0" cellpadding="0" cellspacing="0"> |
| 48 | <tr> |
| 49 | <td valign="top" align="left"> |
| 50 | <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/design.png?format=raw" width="150" alt="Design/Setup"></a> |
| 51 | </td> |
| 52 | <td> |
| 53 | <h3><u>1. Verify your Environment Setup: </u></h3> |
| 54 | This exercise assumes you have already setup your account at the GENI Portal. In particular ensure that: |
| 55 | <ol> |
| 56 | <li> You can login to the <a href="https://portal.geni.net"> GENI Portal </a></li> |
| 57 | <li> You are a member of a GENI Project (there is at least a project listed under the ''Projects'' tab. </li> |
| 58 | <li> You have setup your ssh keys (there is at least one key listed under the ''Profile->SSH Keys'' tab. </li> |
| 59 | </ol> |
| 60 | <h3><u> 2. Setup the Topology: </u></h3> |
| 61 | <ol> |
| 62 | <li> Login to the <a href="https://portal.geni.net"> GENI Portal </a> </li> |
| 63 | <li> Reserve resources within this slice using the <a href="http://www.gpolab.bbn.com/experiment-support/IPRouting/EG-3nodes-mesh.rspec"> EG-3nodes-mesh </a>rspec</li> |
| 64 | </ol> |
| 65 | |
| 66 | |
| 67 | </td> |
| 68 | </tr> |
| 69 | </table> |
| 70 | }}} |
| 71 | '''Action:'' Take a screenshot of the topology in Flack after it is ready and include it in your write up </h3> |
| 72 | ---- |
45 | | == Set Up == |
| 74 | {{{ |
| 75 | #!html |
| 76 | <table border="0" cellpadding="0" cellspacing="0"> |
| 77 | <tr> |
| 78 | <td valign="top" align="left"> |
| 79 | <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/execute.png?format=raw" height="150" alt="Execute"></a> |
| 80 | </td> |
| 81 | <td> |
| 82 | <h3><u> Step 3: View Results: </u></h3> |
| 83 | For this example experiment we used the install script facility to automatically install the necessary software and kick-off the experiment. In this very simple setup, we have installed and launched a |
| 84 | <a href="[http://en.wikipedia.org/wiki/Web_server" target="_blank"> web server </a> as well as an <a href="http://en.wikipedia.org/wiki/Iperf" target="_blank"> iperf server</a>, on the server host. On the client, we have started some processes to test both of these services. To view the results of this experiment: |
| 85 | <table border="0"> |
| 86 | <tr> |
| 87 | <td > |
| 88 | <ol type="a"> |
| 89 | <li> After the background of your slice turns green, press the (i) button that is on the server node icon.</li> |
| 90 | <li> In the information tab that came up, press the <b>Visit</b> button. A new tab should come up that looks like the picture on the side. </li> |
| 91 | <li> Click the <b>Web Server Statistics</b> link to look at statistics. Refresh the page a couple of times to see how the statistics change as the client requests documents.</li> |
| 92 | <li> Click the <b>Logs from the iperf Server</b> link to see the statistics from the iperf transfers.</li> |
| 93 | </ol> |
| 94 | </td> |
| 95 | |
| 96 | </tr> |
| 97 | </table> |
| 98 | <h3><u> Optional Step 4: Manually generate traffic: </u></h3> |
| 99 | While conducting experiments in GENI, you will often want to run commands directly on the nodes. In this optional step, you will log in to a node and issue commands directly to it. |
| 100 | <ol type="a"> |
| 101 | <li> Follow <a href="http://groups.geni.net/geni/wiki/HowTo/LoginToNodes" target="_blank"> these instructions</a> and log in to the client node </li> |
| 102 | <li> When you have successfully logged in, run this command:<br> |
| 103 | <code> |
| 104 | iperf -c server -P 2 |
| 105 | </code> <br> |
| 106 | This task shouldn't take more than 30 seconds. Change the number after the ` -P ` argument and watch how the performance is affected while you change the number of parallel TCP connections. |
| 107 | </li> |
| 108 | <li> Scroll all the way down the server iperf log, and look at the logs for your transfers </li> |
| 109 | </ol> |
| 110 | |
| 111 | </td> |
| 112 | </tr> |
| 113 | </table> |
| 114 | }}} |
| 115 | |
| 116 | {{{ |
| 117 | #!html |
| 118 | <table border="0" cellpadding="0" cellspacing="0"> |
| 119 | <tr> |
| 120 | <td valign="top" align="left"> |
| 121 | <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/finish.png?format=raw" width="150" alt="Execute"></a> |
| 122 | </td> |
| 123 | <td> |
| 124 | <h3><u> Step 5: Cleanup experiment: </u></h3> |
| 125 | After you are done with your experiment, you should always release your resources so that other experimenters can use |
| 126 | the resources. In order to cleanup your slice : |
| 127 | <ol type="a"> |
| 128 | <li>Press the <b>Delete</b> button in the bottom of your canvas </li> |
| 129 | <li> Select <b>Delete at used managers</b> and <b>confirm</b> your selection. </li> |
| 130 | </ol> |
| 131 | Wait and after a few moments all the resources will have been released and you will have an empty canvas again. Notice that your slice is still there. There is no way to delete a slice, it will be removed automatically after its expiration date, but remember that a slice is just an empty container so it doesn't take up any resources. |
| 132 | |
| 133 | |
| 134 | </td> |
| 135 | </tr> |
| 136 | </table> |
| 137 | }}} |