Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/GettingStarted_PartII_Hadoop/Procedure/Execute


Ignore:
Timestamp:
03/07/14 10:23:20 (10 years ago)
Author:
sedwards@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • GENIExperimenter/Tutorials/GettingStarted_PartII_Hadoop/Procedure/Execute

    v1 v1  
     1= [http://groups.geni.net/geni/wiki/GENIEducation/SampleAssignments/UnderstandAMAPI/Procedure  Understanding the AM API] =
     2{{{
     3#!html
     4
     5<div style="text-align:center; width:495px; margin-left:auto; margin-right:auto;">
     6<img id="Image-Maps_5201305222028436" src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Execute.jpg?format=raw" usemap="#Image-Maps_5201305222028436" border="0" width="495" height="138" alt="" />
     7<map id="_Image-Maps_5201305222028436" name="Image-Maps_5201305222028436">
     8<area shape="rect" coords="18,18,135,110" href="./DesignSetup" alt="" title=""    />
     9<area shape="rect" coords="180,18,297,111" href="./Execute" alt="" title=""    />
     10<area shape="rect" coords="344,17,460,110" href="./Finish" alt="" title=""    />
     11<area shape="rect" coords="493,136,495,138" href="http://www.image-maps.com/index.php?aff=mapped_users_5201305222028436" alt="Image Map" title="Image Map" />
     12</map>
     13<!-- Image map text links - End - -->
     14
     15</div>
     16}}}
     17
     18== 4 Wait for experiment setup ==
     19
     20You can tell whether your nodes are ''ready'' by using a script built on `omni` called `readyToLogin`.
     21
     22{{{
     23#!html
     24<ol type='a'>
     25  <li>
     26    Please use the command:
     27<pre>
     28readyToLogin --no-keys -a AM_NICKNAME SLICENAME
     29<pre>
     30where (as before) <tt>AM_NICKNAME</tt> and <tt>SLICENAME</tt> are your aggregate
     31manager nickname and your slice name (both found on your worksheet).
     32  </li>
     33  <li>If it reports that the sliver is not yet ready (for example, it might say that the status is "changing"), then please wait a minute
     34or two and try again.  Once everything is complete, <tt>readyToLogin</tt>
     35will give output that should look something like this:
     36<pre>
     37...
     38server's geni_status is: ready (am_status:ready)
     39User example logs in to server using:
     40        ssh -p 32768 example@pc1.utah.geniracks.net
     41User example logs in to client using:
     42        ssh -p 32769 example@pc1.utah.geniracks.net
     43...
     44</pre>
     45
     46<table border="0" cellpadding="0" cellspacing="0"><tr><td><img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/warning-icon-hi.png?format=raw" width='50' height='50' /></td><td>If you didn't previously complete the Flack tutorial (or are not running an <tt>ssh</tt> agent), then your <tt>ssh</tt> client might
     47not be set up to log in with above commands.  Try re-running <tt>readyToLogin</tt> without the <tt>--no-keys</tt> option, and it will give you one or
     48more <tt>ssh</tt> commands to choose from (which should work, although might require the key passphrase).</td></tr></table>
     49
     50  </li>
     51</ol>
     52}}}
     53
     54== 5 Browse server webpage and log in to client node ==
     55
     56The `install` and `execute` services requested in our RSpec have
     57already started, and the apache webserver has started on the server and measurements are now being collected.
     58
     59{{{
     60#!html
     61<table>
     62<tr><td>
     63<ol type='a'>
     64<li>
     65Enter the hostname of the server node in your browser.  It should bring up a webpage of statistics from your experiment similar to that shown in the figure.
     66</li>
     67</ol>
     68</td>
     69        <td>
     70        <img
     71      src="http://groups.geni.net/geni/attachment/wiki/GENIEducation/SampleAssignments/UnderstandAMAPI/Graphics/webserver_v1.png?format=raw"
     72      alt="Enter the hostname in your browser to see statistics"  width="300"
     73      title="Enter the hostname in your browser to see statistics" /> </a>
     74         <br/>
     75         <b>Figure 5-1</b> Enter the hostname of the <i>server</i> node in your browser to see statistics</i>
     76       </td>
     77</tr>
     78<tr>
     79<td>
     80<ol type='a' start='2'>
     81  <li>Find the <code>ssh</code> commands for your client in your <code>readyToLogin</code> output.  Copy and paste those <code>ssh</code> commands directly into your terminal
     82to log in.  You should see a shell prompt
     83from the remote end:
     84<pre>
     85     [example@client ~]$
     86</pre>
     87
     88<table id="Table_01" border="0" cellpadding="5" cellspacing="0">
     89        <tr>
     90                <td>
     91                        <img src="http://trac.gpolab.bbn.com/gcf/raw-attachment/wiki/Graphics/4NotesIcon_512x512.png" width="50" height="50" alt="Note">
     92               </td>
     93<td>
     94While you're welcome to inspect either
     95the client or server, for the purpose of this experiment the <tt>client</tt> host is the one
     96running the <tt>iperf</tt> tests and collecting all the logs.
     97</td>
     98        </tr>
     99</table>
     100</li>
     101<li>
     102
     103Look in the <code>/local</code> directory to see the install scripts and other files from the Archive you specified in your RSpec:
     104<pre>
     105cd /local
     106ls
     107</pre>
     108</li>
     109<li>
     110Look for the <code>iperf</code> and <code>wget</code> processes started by your install scripts:
     111<pre>
     112ps ax
     113</pre>
     114
     115<table id="Table_03" border="0" cellpadding="5" cellspacing="0">
     116        <tr>
     117                <td>
     118                        <img src="http://groups.geni.net/geni/attachment/wiki/GENIExperimenter/Tutorials/Graphics/Symbols-Tips-icon.png?format=raw" width="50" height="50" alt="Tip">
     119               </td>
     120               <td>
     121If you do not see the proper files and processes, please double-check the <code>RSpec</code> you used in the previous step.
     122        </tr>
     123</table>
     124
     125</li>
     126</ol>
     127       </td>
     128
     129      </tr>
     130<tr><td>
     131</td></tr>
     132</table>
     133}}}
     134
     135
     136
     137The client machine is saving all the test results in the `/tmp/iperf-logs`
     138directory.  Files with timestamps in the names will gradually appear
     139there (there are 100 tests overall, and it may take 20 minutes for all
     140of them to complete if you want to wait for them). 
     141
     142Each log file corresponds to one test with some number of simultaneous
     143TCP connections over the VLAN link you requested between the two hosts.
     144Later tests gradually include more concurrent connections, so the
     145throughput of each individual connection will decrease, but the
     146aggregate throughput (the `[SUM]` line at the end of each file)
     147should remain approximately consistent.
     148
     149
     150
     151== 6.  Analyze Experiment ==
     152
     153For a real experiment, of course, this step would be the most important
     154and collection, analysis and archival of the results would be critical,
     155but for now, play around as necessary to satisfy your curiosity and
     156then continue.
     157
     158----
     159
     160= [wiki:GENIExperimenter/Tutorials/GettingStarted_PartII_Hadoop/Procedure Introduction] =
     161= [wiki:GENIExperimenter/Tutorials/GettingStarted_PartII_Hadoop/Procedure/Finish Next:  Finish] =