diff --git a/www/faq.html b/www/faq.html index 1bf69672060f761a213b51e56f56ffa737aae9c6..465ca1f52925ae55e330fee0f53452abbe935954 100644 --- a/www/faq.html +++ b/www/faq.html @@ -19,7 +19,8 @@
  • I have an Emulab account. Now what?
  • Can I be in more than one project?
  • Can I change my Emulab password? -
  • Where do I get help? +
  • I'm a project leader. Can I designate TAs? +
  • Where do I get help?
  • Using the Testbed @@ -34,6 +35,7 @@ backed up (filesaved)?
  • Are the nodes in my experiment backed up (filesaved)? +
  • What is Swapping?
  • Hardware setup @@ -73,7 +75,7 @@

    How do I start a project?

    If you are new to the Testbed, simply click on the "Start Project" - link on the Emulab Home + link on the Emulab Home Page. You will need to fill in the forms with your personal information and information about the project. Then click on the "Submit" button. Within a few days you will be contacted via email @@ -93,7 +95,7 @@

    How do I join a project?

    If you are new to the Testbed, simply click on the "Join Project" - link on the Emulab Home + link on the Emulab Home Page. You will need to fill in the form with your personal information, and provide the name of the project you are trying to join (typically, the Project Leader will have told you the @@ -143,6 +145,36 @@

  • +

    I'm a project leader. Can I designate TAs?

    +

    + Yes. To designate a TA, you must first create a project + 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. When you create a group, + you designate a group leader 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 default group. 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.). +

    + +

    + 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 Emulab Documentation page in the + Groups Tutorial. +

    + +
  • Where do I get help?

    If you cannot find an answer to your question in the @@ -272,6 +304,26 @@ since quotas on /users are relatively small.

    +
  • +

    What is Swapping

    +

    + 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. +

    + +

    + 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. +

    +
    diff --git a/www/groups.html b/www/groups.html new file mode 100644 index 0000000000000000000000000000000000000000..a9a76c3b7fb66b42205b7d6e5a7f79d8e6f89462 --- /dev/null +++ b/www/groups.html @@ -0,0 +1,70 @@ + + + Emulab.Net - Information on Project Groups + + + + + +
    +

    Project Groups

    +
    + +

    +As an instructional aid, project leaders may designate TAs to lead +small groups of project members. This is accomplished by creating a +group (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. +

    + +

    +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 Create New Group +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. +

    + +

    +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 +Join your group by telling them to go to the Join Project 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 New User +Approval 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. +

    + +

    +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. +

    +