This page shows the basic steps for running Moss. Your course may have scripts that combine these steps.
Put the files that Moss should check somewhere in the course account. Contact CSCF if you don't have access to the course account. Place the files in a folder that contains a folder for each student, like this:
files_to_check |- yc2lee | |- helper.cc | |- mycode.cc |- omnafees | |- mycode.cc |- fhgunn | |- test.cc | |- main.cc
Do not include any files that you do not want Moss to check, such as automated testing results and .svn/.git folders. Moss will compare files even if the filenames are different.
SSH into your course account on linux.student.cs.uwaterloo.ca.
Run Moss using the RunMoss script. Example (the O after yes is capital letter O, not zero)::
yes O | /u/isg/bin/runMoss -d path/to/files_to_check '-l ascii'
Replace path/to/files_to_check with the path to the folder you made in Step 1. The yes O tells runMoss to process folders for students that aren't enrolled in your class; if you leave it out, you'll get a prompt for any folders that aren't for a student in your class.
The '-l ascii' part contains extra options for Moss. Put these extra options inside a pair of quotes. Extra options include:
More details on the extra options are in the file /u/cs_build/moss/moss.pl.
If you see an error like runMoss_impl: command not found then your course account doesn't have access to the Moss scripts. Please contact CSCF with your course's name to get access.
RunMoss will create a folder called html. Go in and open index.html in a web browser to view the results. Instructions on mounting course accounts is on WebHome, accessing course accounts section.
Optional: If you find the results hard to read, you can run MossMakeReadable on the index.html:
/u/isg/bin/moss_makereadable index.html 15 > readable.html
This command will create a file readable.html with some nicer formatting. The optional 15 makes it only show pairs where at least one student matches 15% or more.
Some caveats: