ISG: Course Account Training

Resources:www.cs.uwaterloo.ca/isg/

>Tutor/TA Handbook >Training>scripts

>ISG WiKi

Agenda• Connecting to the Course Account

• Structure of Course Account

• Maintenance of Course Account

• Assignment Submission

• Support Scripts

• Email

• ISG Wiki

Viewing filesystem - Finder

• From the Mac Finder, select the “Go” menu, then click “Connect to Server…”

Viewing filesystem - Finder

• Type in the server addresssmb://smb-shares.student.cs.uwaterloo.ca/csNNN

where NNN is a course number

Viewing filesystem - Finder

Logging in – command line• Use ssh; i.e.,ssh localhost -l csNNNssh csNNN@<undergrad-machine>

Logging in – command line• If you have an ssh key already

generated on the student.cs systems, you’re done

• Otherwise, run the command

ssh-keygen -b 2048 -t rsahttp://www.cs.uwaterloo.ca/cscf/howto/ssh/public_key/#openssh

Important Files: .classlist• .classlist (also called .classlist.$term)

• Read-only, updated regularly by CFCF from Registrar’s info

• Do not change permissions on this file; instead, use:• .exceptionlist.$term• .coursestaff.$term

https://www.cs.uwaterloo.ca/twiki/view/ISG/ClassListPerlModule

Important Files: .login

• Normally contains only the following line:

exec /u/isg/bin/login• Automates access to standardized tools

on command line, and creation of a directory for your personalized configuration and files.

• Automatically creates directory under /u/csNNN/u

Important files: .rhosts

• Gives people access to the course account; check first with ISC.• Put person in .rhosts file in /u/csNNN• Rest takes care of itself when they connect if

they have an account on student.cs

• Within an hour, personal ssh keys should be added to the authorized keys for the course account

Important Directories

archives

bin

course

handin

marking

marks

pub / public_html

u

/u/csNNN

Directory: archives

• Contains material used in previous terms (assignment submissions, web content, etc.)

• Can be interesting to see how things like marking scripts were done before, but knowledge transfer is more properly done via the Wiki:

https://www.cs.uwaterloo.ca/twiki/view/ISG/WebHome

Directory: bin

• Contains scripts/programs specific to this course

• Any scripts located here should be available to you automatically because of the login program.

Directory: course

• Contains data about the course, which varies from account to account. Can include snapshots of course enrolment, records of public test results, …

Directories: handin/marking

• Depending on course structure, may contain assignment submissions and assignment autotesting suites, respectively.

Directory: u

• Parent directory of the personalized directory created for you by the login script. Contains configuration and personal files of users of the course account.

• Files specific to you belong here, instead of elsewhere on the account.

Web Site

• public_html• Ensure list of course staff is up-to-

date at beginning of term

• Update announcements and marks regularly

• Set a good example by making websites that validate!

Web Site: displayMarks• Uses marks, which normally also

contains the mark spreadsheet

• CSV files read by this program should be generated regularly from the spreadsheet so students get prompt feedback.

https://www.cs.uwaterloo.ca/twiki/view/ISG/OnlineMarkUpload

Web Site: displayMarks• Sample spreadsheet and generated

file (from Wiki)

Web Site: displayMarks• Sample user display

Web Site: displayMarks• Sample root user display

Submission: submit/Odyssey• Student submissions in handin,

partitioned by assignment and then by userid• .submitrc: global configuration• .subfiles: list of files to submit for an

assignment• .lates: list of students who handed

assignment in late; maintained by scripts deadline, makelateclone, submit, and unlate

Submission: Marmosethttps://marmoset.student.cs.uwaterloo.ca/

Submission: Markushttps://markus.cs.uwaterloo.ca/

https://www.student.cs.uwaterloo.ca/markus/csNNN

Submission: UW-ACEhttp://uwace.uwaterloo.ca/

Scripts

• Purposes:• Cover page • Auto-marking• Plagiarism detection• Course announcements• …

http://www.student.cs.uwaterloo.ca/~isg/scripts/

Cover Pages(Written Assignments)

• Configuration file .coverrc• Command makeCover• For each assignment, add list of

questions and marks per question to .coverrc

Automarking: RST

• Scripts for testing and printing use rst <assign> <suite> [<identifier>] where:

•rst is /u/isg/bin/rst, •assign = subdirectory of marking•suite = name of directory holding scripts•identifier = name of this test run

• Suite pt is used for public tests• Also see rsta and distrst

Automarking: BitterSuite

• Testing framework used in some courses; abstracts away from mechanism of how tests are run so tutors can focus on designing tests instead of the details of maintaining scripts.

• Typically run via RST

Automarking: printOut

• Not used in MarkUs-based courses• printOut <assign> <suite> <timestamp> <piles> <where>• piles = 'section' or number of piles, • where = -7 for lp7_cs , -0 for don't actually print, -g for Graphics Services Xerox 470

Plagiarism detection: moss

• runMoss, moss_makereadable, and moss_getgroups

• Used to get statistically matching results, eliminate any matches that don’t reach a certain threshold, and find clusters that may not be apparent in moss’s pairwise results.

Course announcements

• announce utility• Posts to course website, RSS Feed,

and newsgroup.• Should be used for all major

information that needs to be pushed to all students.

Course Email

• When in doubt, check with instructors/ISC first (or forward to them)

• Carbon-copy replies so:• others know a reply has been sent• record is kept in case of problem

https://www.cs.uwaterloo.ca/twiki/view/ISG/ProcmailSetup

ISG Wiki

ISG Wiki• Important resource to supplement

material in this and other presentations• Should be used regularly throughout

the term to check how to do things• Should be updated regularly

throughout the term so information stays current

https://www.cs.uwaterloo.ca/twiki/view/ISG/WebHome

The End

Resources:www.cs.uwaterloo.ca/isg/

>Tutor/TA Handbook >Training>scripts

>ISG WiKi