Commit abb71852 authored by Leigh B. Stoller's avatar Leigh B. Stoller

Update FAQ entry for swapping to include info about what the swappable

check box means. Also add links from the begin experiment page and
from the experiment information page to the FAQ entry. Lets see if
this helps.
parent da498bd5
...@@ -133,47 +133,46 @@ echo "<tr> ...@@ -133,47 +133,46 @@ echo "<tr>
<td><input type=checkbox name=exp_shared value=Yep>&nbsp Yes</td> <td><input type=checkbox name=exp_shared value=Yep>&nbsp Yes</td>
</tr>\n"; </tr>\n";
?> echo "<tr>
<td align=center colspan=3>
<tr> <b><input type=submit value=Submit></b></td>
<td align="center" colspan="3"> </tr>
<b><input type="submit" value="Submit"></b></td> </form>
</tr> </table>\n";
</form>
</table> echo "<h4><blockquote><blockquote><blockquote>
<dl COMPACT>
<h4><blockquote><blockquote><blockquote> <dt>[1]
<dl COMPACT> <dd>Check if your experiment can be swapped out and swapped back
<dt>[1] in without harm to your experiment. Useful for scheduling when
<dd>Check if your experiment can be swapped out and swapped back in resources are tight. More information on swapping
without harm to your experiment. Useful for scheduling when is contained in the
resources are tight. <a href='$TBDOCBASE/faq.php3#UTT-Swapping'>Emulab FAQ</a>.
<dt>[2] <dt>[2]
<dd>You get brownie points for marking your experiments as Low <dd>You get brownie points for marking your experiments as Low
Priority, which indicates that we can swap you out before high Priority, which indicates that we can swap you out before high
priority experiments. priority experiments.
<dt>[3] <dt>[3]
<dd>Leave blank to use the default group for the project. <dd>Leave blank to use the default group for the project.
<dt>[4] <dt>[4]
<dd>Leave unchecked unless you know what this means! <dd>Leave unchecked unless you know what this means!
</dl> </dl>
</blockquote></blockquote></blockquote></h4> </blockquote></blockquote></blockquote></h4>\n";
<p> echo "<p><blockquote>
<blockquote> <ul>
<ul> <li> Please <a href='nscheck_form.php3'>syntax check</a> your NS
<li> Please <a href="nscheck_form.php3">syntax check</a> your NS file first! file first!
<li> If your NS file is using a custom OSID, you must <li> If your NS file is using a custom OSID, you must
<a href="newosid_form.php3">create the OSID first!</a> <a href='newosid_form.php3'>create the OSID first!</a>
<li> <li> You can view a <a href='showosid_list.php3'> list of OSIDs</a>
You can view a <a href="showosid_list.php3"> list of OSIDs</a> that are available for you to use in your NS file.
that are available for you to use in your NS file. <li>
<li> You can also view a <a href='showimageid_list.php3'> list of
You can also view a <a href="showimageid_list.php3"> list of ImageIDs.</a> ImageIDs.</a>
</ul> </ul>
</blockquote> </blockquote>\n";
<?php
# #
# Standard Testbed Footer # Standard Testbed Footer
# #
......
...@@ -14,6 +14,7 @@ ...@@ -14,6 +14,7 @@
<ul> <ul>
<li> <a href="#GS">Getting Started</a> <li> <a href="#GS">Getting Started</a>
<ul> <ul>
<li> <a href="#GS-Eligible">Who is Eligible to use Emulab.Net?</a>
<li> <a href="#GS-1">How do I start a project?</a> <li> <a href="#GS-1">How do I start a project?</a>
<li> <a href="#GS-2">How do I join a project?</a> <li> <a href="#GS-2">How do I join a project?</a>
<li> <a href="#GS-3">I have an Emulab account. Now what?</a> <li> <a href="#GS-3">I have an Emulab account. Now what?</a>
...@@ -43,7 +44,10 @@ ...@@ -43,7 +44,10 @@
<li> <a href="#HDS-1">How many nodes are there?</a> <li> <a href="#HDS-1">How many nodes are there?</a>
<li> <a href="#HDS-2">How many nodes are currently available?</a> <li> <a href="#HDS-2">How many nodes are currently available?</a>
<li> <a href="#HDS-3">How many ethernet cards are on each node?</a> <li> <a href="#HDS-3">How many ethernet cards are on each node?</a>
<li> <a href="#HDS-4">Can I do traffic shaping on my links?</a> <li> <a href="#HDS-4">How many nodes are currently available (free)?</a>
<li> <a href="#HDS-5">Can I do traffic shaping on my links?</a>
<li> <a href="#HDS-6">Can I modify the traffic shapping
parameters on my links?</a>
</ul> </ul>
<li> <a href="#SWS">Software setup</a> <li> <a href="#SWS">Software setup</a>
...@@ -71,6 +75,19 @@ ...@@ -71,6 +75,19 @@
<a NAME="GS"></a> <a NAME="GS"></a>
<h3>Getting Started</h3> <h3>Getting Started</h3>
<ul> <ul>
<li><a NAME="GS-Eligible"></a>
<h3>Who is Eligible to use Emulab.Net?</h3>
<p>
Emulab.Net is an NSF/DARPA sponsored project, with additional
support from these <a href =
"docwrapper.php3?docname=sponsors.html"> sponsors</a>. As such,
eligibility to use Emulab is primarily granted to other NSF/DARPA
sponsored projects, as well as current university research
projects. There are exceptions of course. If you are unsure about
your eligibility to use Emulab, please feel free to send us an email
inquiry.
</p>
<li><a NAME="GS-1"></a> <li><a NAME="GS-1"></a>
<h3>How do I start a project?</h3> <h3>How do I start a project?</h3>
<p> <p>
...@@ -320,9 +337,26 @@ ...@@ -320,9 +337,26 @@
in the web interface, but no nodes are allocated. Once an in the web interface, but no nodes are allocated. Once an
experiment is swapped out, you can swap it back in via the web experiment is swapped out, you can swap it back in via the web
interface by going to the Experiment Information page for your interface by going to the Experiment Information page for your
experiment, and clicking on the swapin option. experiment, and clicking on the swapin option.
</p> </p>
<p>
The <tt>swappable</tt> checkbox in the Begin Experiment web page
is used to determine what experiments can be <em>automatically</em>
swapped by the testbed scheduling system. Note that all experiments are
capable of being swapped; even if you do not check the swappable box,
you are free to swap your own experiments as you like. The only
difference is that the testbed scheduling system will not consider your
experiment when looking for experiments to swap out. You will sometimes
notice that the Experiment Information page does not contain the swap
link. That is because experiments cannot be swapped when they are in
transition. For example, when the experiment is being swapped in (say,
after first being created) the link will disappear until the experiment
is fully swapped in, and it is capable of being swapped out. You will
need to occasionally reload the page so that the updated state is
recognized and the swap link appears.
</p>
<p> <p>
Be aware that we do not currently save any files that you may have Be aware that we do not currently save any files that you may have
placed on your nodes. When your experiment is swapped back in, you placed on your nodes. When your experiment is swapped back in, you
...@@ -377,6 +411,21 @@ ...@@ -377,6 +411,21 @@
<a href = "tutorial/tutorial.php3">Emulab Tutorial</a> for an <a href = "tutorial/tutorial.php3">Emulab Tutorial</a> for an
example. example.
</p> </p>
<li><a NAME="HDS-6"></a>
<h3>Can I modify the traffic shapping parameters on my links?</h3>
<p>
Yes! If your NS file specified traffic shaping on a link, then you
can subsequently modify those parameters after the experiment has
been swapped in. Note that you cannot <em>convert</em> a non shaped
link into a shaped link; you can only modify the traffic shaping
parameters of a link that is already being shaped. To modify the
parameters, log into <b>users.emulab.net</b> and use the
<tt>delay_config</tt> program. This program requires that you know
the symbolic names of the individual links. This information is
available via the web interface on the Experiment Information
page.
</p>
</ul> </ul>
<hr> <hr>
......
...@@ -383,7 +383,7 @@ function SHOWUSER($uid) { ...@@ -383,7 +383,7 @@ function SHOWUSER($uid) {
# Show an experiment. # Show an experiment.
# #
function SHOWEXP($pid, $eid) { function SHOWEXP($pid, $eid) {
global $TBDBNAME; global $TBDBNAME, $TBDOCBASE;
$query_result = $query_result =
DBQueryFatal("SELECT * FROM experiments WHERE ". DBQueryFatal("SELECT * FROM experiments WHERE ".
...@@ -422,9 +422,7 @@ function SHOWEXP($pid, $eid) { ...@@ -422,9 +422,7 @@ function SHOWEXP($pid, $eid) {
echo "<tr> echo "<tr>
<td>Name: </td> <td>Name: </td>
<td class=\"left\"> <td class=left>$eid</td>
<A href='shownsfile.php3?pid=$pid&eid=$eid'>
$eid</a></td>
</tr>\n"; </tr>\n";
echo "<tr> echo "<tr>
...@@ -472,7 +470,7 @@ function SHOWEXP($pid, $eid) { ...@@ -472,7 +470,7 @@ function SHOWEXP($pid, $eid) {
</tr>\n"; </tr>\n";
echo "<tr> echo "<tr>
<td>Swappable: </td> <td><a href='$TBDOCBASE/faq.php3#UTT-Swapping'>Swappable:</a></td>
<td class=\"left\">$swappable</td> <td class=\"left\">$swappable</td>
</tr>\n"; </tr>\n";
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment