Class Accounts and Use
AttentionThis 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 teacher.
AttentionThis guide assumes you are using the reference portal at
mod.deterlab.net. Instructions on this page only apply to that portal.
Teachers and students will have their account automatically set up by our legacy software. Teachers please refer to guidelines in our legacy documentation, which have been updated. Students, your accounts will be created by your teacher.
Using DeterLab as a Teacher
Teachers 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 teacher 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 teachers 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 teacher 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 teacher 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
su - yourusername
Otherwise proceed to the next step.
- If you are just starting an assignment, to start an experiment, type
Wait until the screen indicates that this has completed. Then type:
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 tarminal window type:
For example, if your topology has nodes
ssh a or
ssh 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.
When you finish an assignment, release the resources by repeating steps 1,2,3,4 above and then typing:
Answer the questions specified in your lab materials and submit answers using our legacy site.
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.
Your assignment may ask you to perform port forwarding. Follow instructions here to set up port forwarding.