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

Some faq updates (swapping and groups). A longer groups description.

parent 895a44f6
...@@ -19,7 +19,8 @@ ...@@ -19,7 +19,8 @@
<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>
<li> <a href="#GS-4">Can I be in more than one project?</a> <li> <a href="#GS-4">Can I be in more than one project?</a>
<li> <a href="#GS-5">Can I change my Emulab password?</a> <li> <a href="#GS-5">Can I change my Emulab password?</a>
<li> <a href="#GS-6">Where do I get help?</a> <li> <a href="#GS-6">I'm a project leader. Can I designate TAs?</a>
<li> <a href="#GS-7">Where do I get help?</a>
</ul> </ul>
<li> <a href="#UTT">Using the Testbed</a> <li> <a href="#UTT">Using the Testbed</a>
...@@ -34,6 +35,7 @@ ...@@ -34,6 +35,7 @@
backed up (filesaved)?</a> backed up (filesaved)?</a>
<li> <a href="#UTT-7">Are the nodes in my experiment backed up <li> <a href="#UTT-7">Are the nodes in my experiment backed up
(filesaved)?</a> (filesaved)?</a>
<li> <a href="#UTT-Swapping">What is Swapping?</a>
</ul> </ul>
<li> <a href="#HDS">Hardware setup</a> <li> <a href="#HDS">Hardware setup</a>
...@@ -73,7 +75,7 @@ ...@@ -73,7 +75,7 @@
<h3>How do I start a project?</h3> <h3>How do I start a project?</h3>
<p> <p>
If you are new to the Testbed, simply click on the "Start Project" If you are new to the Testbed, simply click on the "Start Project"
link on the Emulab <a href="https://www.emulab.net">Home link on the Emulab <a href="http://www.emulab.net">Home
Page</a>. You will need to fill in the forms with your personal Page</a>. You will need to fill in the forms with your personal
information and information about the project. Then click on the information and information about the project. Then click on the
"Submit" button. Within a few days you will be contacted via email "Submit" button. Within a few days you will be contacted via email
...@@ -93,7 +95,7 @@ ...@@ -93,7 +95,7 @@
<h3>How do I join a project?</h3> <h3>How do I join a project?</h3>
<p> <p>
If you are new to the Testbed, simply click on the "Join Project" If you are new to the Testbed, simply click on the "Join Project"
link on the Emulab <a href="https://www.emulab.net">Home link on the Emulab <a href="http://www.emulab.net">Home
Page</a>. You will need to fill in the form with your personal Page</a>. You will need to fill in the form with your personal
information, and provide the name of the project you are trying to information, and provide the name of the project you are trying to
join (typically, the <i>Project Leader</i> will have told you the join (typically, the <i>Project Leader</i> will have told you the
...@@ -143,6 +145,36 @@ ...@@ -143,6 +145,36 @@
</p> </p>
<li><a NAME="GS-6"></a> <li><a NAME="GS-6"></a>
<h3>I'm a project leader. Can I designate TAs?</h3>
<p>
Yes. To designate a TA, you must first create a project
<em>group</em>. A project group is a lot like a unix group, and
in fact unix groups is the mechanism used to protect members of
one group from members of another group. When you create a group,
you designate a <em>group leader</em> who is responsible for
approving users who apply to join the group. Group leaders may
also terminate experiments that have been created by members of
the group. As Project Leader, you may also shift members of your
project in and out of your project's groups as you like, and you
are automatically a member of all groups within your project. As a
convenience, all new projects are created with one new group,
termed the <em>default group</em>. As its name implies, whenever
the group is left unspecified in a form, it defaults to the
project group (this allows you to create a project without any sub
groups at all; new members join the default group, new experiments
are created in the default group, etc.).
</p>
<p>
Project groups are created via the Project Information link at
your left. Simply go to the project page in which you want to
create a group, and look for the "Create New Group" link. More
information on project groups is available via the <a
href="doc.php3">Emulab Documentation</a> page in the
<a href="docwrapper.php3?docname=groups.html">Groups Tutorial</a>.
</p>
<li><a NAME="GS-7"></a>
<h3>Where do I get help?</h3> <h3>Where do I get help?</h3>
<p> <p>
If you cannot find an answer to your question in the If you cannot find an answer to your question in the
...@@ -272,6 +304,26 @@ ...@@ -272,6 +304,26 @@
since quotas on /users are relatively small. since quotas on /users are relatively small.
</p> </p>
<li><a NAME="UTT-Swapping"></a>
<h3>What is Swapping</h3>
<p>
Swapping is when you (or us) temporarily swap your experiment out,
releasing all of the nodes in the experiment. Your experiment is
still resident in the Emulab database, and you can see its status
in the web interface, but no nodes are allocated. Once an
experiment is swapped out, you can swap it back in via the web
interface by going to the Experiment Information page for your
experiment, and clicking on the swapin option.
</p>
<p>
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
will likely get different nodes, and with fresh copies of the disk
images. For that reason, you should not swap your experiment out
unless you make arrangements to save and restore any state you need.
</p>
</ul> </ul>
<hr> <hr>
......
<html>
<head>
<title>Emulab.Net - Information on Project Groups</title>
<link rel='stylesheet' href='tbstyle-plain.css' type='text/css'>
</head>
<body>
<basefont size=4>
<center>
<h2>Project Groups</h2>
</center>
<p>
As an instructional aid, project leaders may designate TAs to lead
small groups of project members. This is accomplished by creating a
<em>group</em> (sometimes referred to as a "subgroup"), and
designating the TA as the leader of the group. A project group is a
lot like a unix group, and in fact unix groups is the mechanism used
to protect members of one group from members of another group on
Emulab nodes. For each group created, a new unix group is created, and
the members of the group added. When a group member starts an
experiment, he/she indicates the group in the Begin Experiment
form. All of the nodes in the experiment will have user accounts built
for only those members of the group. In this way, multiple subgroups
of a project can work independently, and be protected from each other
via the generally well understood unix group protection mechanism.
</p>
<p>
As project leader, you may create and destroy groups, and add and
remove project members from your groups. You are automatically a
member of new groups you create; even though you are not the
designated leader of the group, you still retain all of the same
permissions that you have as project leader, within the group. This
means that you can terminate experiments that have been created within
the group, and edit the personal information for group members. To
create a group, simply go to the Project Information link at your
left, and look for the "Create New Group" link, or go to the <a
href=https://www.emulab.net/newgroup_form.php3>Create New Group</a>
page directly. Once you have created a group, you can edit the
members of the group by clicking on the "Edit" option in the group
information page.
</p>
<p>
As group leader, you may approve new user applications to join your
group. You may also create and destroy experiments created within the
group. If you are a TA managing a group, you can have new Emulab users
<em>Join</em> your group by telling them to go to the <a
href=https://www.emulab.net/addusr.php3>Join Project</a> link at your
left, and specifying the name of your group where it asks for a group
name. You will receive an email message for each person that applies
to join your group. To approve (or deny) membership in your group, use
the <a href=https://www.emulab.net/approveuser_form.php3>New User
Approval</a> link. If the user who wishes to join your group is
already a member of the project, then the project leader must add them
to your group. In other words, there is no mechanism to join multiple
groups via a web form; the Project Leader must do it on the Edit Group
page.
</p>
<p>
As mentioned above, unix groups are used to protect members one group
from members of another group. User may create shared directories by
using the unix "chgrp" command. When accounts are created on the
experimental nodes after a new experiment is started, only those
members of the group will get accounts on the nodes; other members of
the same project, not in the group, will not get accounts.
</p>
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