Changes between Initial Version and Version 1 of GENIEducation/SampleAssignments/UnderstandAMAPI/Procedure/Execute

Timestamp:

08/08/13 15:44:58 (11 years ago)

Author:

sedwards@bbn.com

Comment:

--

GENIEducation/SampleAssignments/UnderstandAMAPI/Procedure/Execute

@@ +1 @@
+= [http://groups.geni.net/geni/wiki/GENIEducation/SampleAssignments/UnderstandAMAPI/Procedure  Understanding the AM API] =
+{{{
+#!html
+
+<div style="text-align:center; width:495px; margin-left:auto; margin-right:auto;">
+<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="" />
+<map id="_Image-Maps_5201305222028436" name="Image-Maps_5201305222028436">
+<area shape="rect" coords="18,18,135,110" href="./DesignSetup" alt="" title=""    />
+<area shape="rect" coords="180,18,297,111" href="./Execute" alt="" title=""    />
+<area shape="rect" coords="344,17,460,110" href="./Finish" alt="" title=""    />
+<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" />
+</map>
+<!-- Image map text links - End - -->
+
+</div>
+}}}
+
+== 6.1 Wait for experiment setup ==
+
+1. Please use the command:
+{{{
+readyToLogin.py --no-keys -a AM_NICKNAME SLICENAME
+}}}
+where (as before) {{{AM_NICKNAME}}} and {{{SLICENAME}}} are your aggregate
+manager nickname and your slice name (both found on your worksheet).
+
+2. 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
+or two and try again.  Once everything is complete, {{{readyToLogin.py}}}
+will give output that should look something like this:
+
+{{{
+...
+server's geni_status is: ready (am_status:ready) 
+User example logs in to server using:
+        ssh -p 32768 example@pc1.utah.geniracks.net
+User example logs in to client using:
+        ssh -p 32769 example@pc1.utah.geniracks.net
+...
+}}}
+
+{{{
+#!html
+<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" /></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
+not be set up to log in with above commands.  Try re-running <tt>readyToLogin.py</tt> without the <tt>--no-keys</tt> option, and it will give you one or
+more <tt>ssh</tt> commands to choose from (which should work, although might require the key passphrase).</td></tr></table>
+}}}
+
+== 6.2 Log in to client node ==
+
+1. Copy and paste the {{{ssh}}} command lines directly into your terminal
+to log in to either of your hosts.  While you're welcome to inspect either
+one, for the purpose of this experiment, the {{{client}}} host is the one
+running the {{{iperf}}} tests and collecting all the logs, so please use
+the {{{client}}} ssh command now.
+
+You may get a warning from {{{ssh}}} complaining that the authenticity of the
+host cannot be established.  This is just because your {{{ssh}}} client has
+never accessed this VM before, and so does not yet recognise its key.  Say
+"yes", you do want to continue connecting, and you should see a shell prompt
+from the remote end:
+{{{
+[example@client ~]$
+}}}
+
+The {{{install}}} and {{{execute}}} services requested in our rspec have
+already started, and measurements are now being collected.  (You can
+verify that things are working by inspecting the {{{/local}}} directory
+on each host, and looking for the approriate processes with a command like
+{{{ps ax}}}.  If you do not see the proper files and processes, please
+double-check the {{{rspec}}} you used in the previous step.)
+
+2. The client machine is saving all the test results in the {{{/tmp/iperf-logs}}}
+directory.  Files with timestamps in the names will gradually appear
+there (there are 100 tests overall, and it may take 20 minutes for all
+of them to complete if you want to wait for them).  
+
+Each log file corresponds to one test with some number of simultaneous
+TCP connections over the VLAN link you requested between the two hosts.
+Later tests gradually include more concurrent connections, so the
+throughput of each individual connection will decrease, but the
+aggregate throughput (the {{{[SUM]}}} line at the end of each file)
+should remain approximately consistent.
+
+For a real experiment, of course, this step would be the most imporant
+and collection, analysis and archival of the results would be critical,
+but for now, play around as necessary to satisfy your curiosity and
+then continue.
+
+----
+
+= [wiki:GENIEducation/SampleAssignments/LabZero/Procedure Introduction] =
+= [wiki:GENIEducation/SampleAssignments/LabZero/Procedure/Finish Next:  Finish] =