Class Accounts and Use
Attention
This guide is only for class users. Research users should refer to instructions here.This guide covers the basic things you need to do to get started using Merge in your classes, as a student or a instructor.
Attention
This guide assumes you are using the reference portal atmod.deterlab.net
. Instructions on this page only apply to that portal.
Account Setup
Instructors and students will have their account automatically set up by our legacy software. Instructors please refer to guidelines in our legacy documentation, which have been updated. Students, your accounts will be created by your instructor.
Using DeterLab as an Instructor
Instructors will use our legacy Web page to create student accounts, retrieve and reset passwords, upload and assign class materials and collect submissions for grading. This workflow remains the same as before. A instructor only needs to migrate their class once and then continue using legacy DeterLab to manage their class as usual.
Migrating Class Materials
If you have used some shared or private class materials on DeterLab, please refer to our guidelines on migrating your materials to our new platform.
Using DeterLab as a Student
Students will receive an email with their username and password as instructors create their DeterLab accounts. The same username and password can be used at our legacy site to access class materials and upload submissions, and at our current site to work on class assignments. Shoud a student forget their password, their instructor can retrieve it or reset it. Please refer to documentation at our legacy site.
Accessing Class Materials
To access class materials log into our legacy site and click on “My Classes” tab.
You will then be able to see materials that your instructor shared with the class, and your assignments. To submit an assignment you would upload one file and click “Submit”.
Working on Assignments
Each assignment will have a name of the lab you will work on, let’s call it labname. To start an experiment and set up the lab follow the steps below.
-
Log into the testbed using your username and password, at current site
-
Click on XDCs (left menu)
-
Click on Jupyter link (center window)
-
Click on Terminal if needed - Terminal app may already be active
-
Only the first time you access the testbed via Terminal app, type the text below.
$ su - yourusername $ echo "PATH=$PATH:/share" > .profile $ echo yourpassword > pass.txt $ exit $ su - yourusername
-
Every other time you access the testbed via Terminal app look at the command line prompt. If the prompt looks like
#
, type$ su - yourusername
Otherwise proceed to the next step.
-
If you are just starting an assignment, to start an experiment, type
$ startexp labname
Wait until the screen indicates that this has completed. Then type:
$ runlab labname
The
runlab
command may appear to hang in the end. Type ENTER and it should indicate that it has completed.If you receive some errors,
- wait a few minutes and try runlab command again.
- If that fails again, re-run the sequence of startexp and runlab one more time.
- If it fails again, please contact your instructor or TA to ask for help.
-
To access your nodes from the terminal window type:
$ ssh nodename
For example, if your topology has nodes
a
andb
typessh a
orssh b
. If you need to access multiple nodes at the same time, open another browser window and repeat steps 1, 2, 3, 4, 6 and then step 8.
Finishing Assignments
When you finish an assignment, release the resources by repeating steps 1,2,3,4 above and then typing:
$ stopexp labname
Answer the questions specified in your lab materials and submit answers using our legacy site.
Copying Files
Your assignment may ask you to include some files from your experimental nodes. Please follow instructions here (scroll all the way to the bottom). The instructions assume you have installed mrg
utility on your home machine. To do so, please obtain the source (and follow README to compile it) or binary from this site. After installation configured your API point (you only have to do this once) and have logged into your merge account by doing mrg login yourusername -p yourpassword
(you have to do this each time you open a new terminal on your machine).
A complete example is in this assignment.
Port Forwarding
Your assignment may ask you to perform port forwarding. Follow instructions here to set up port forwarding.