services:grading
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
services:grading [2019/05/07 15:01] – jas | services:grading [2019/10/03 16:11] – jas | ||
---|---|---|---|
Line 19: | Line 19: | ||
In order to use gsync, follow these easy steps: | In order to use gsync, follow these easy steps: | ||
- | ===== Step 1: Update the Gsync Access Control List For Your Course | + | ===== Step 1: Enable |
- | After you've created | + | After creating |
- | To add users: gsyncu | + | < |
+ | % gsyncu < | ||
+ | </ | ||
+ | |||
+ | **NOTE:** Only the owner of the course directory can use the //gsyncu// command. | ||
+ | |||
+ | For example, if your course is " | ||
+ | |||
+ | < | ||
+ | % gsyncu 9999 create | ||
+ | |||
+ | User bob added to gsync user list. | ||
+ | Gsync is enabled. | ||
+ | Gsync account updates occur once per hour, but only for courses in the current term. | ||
+ | </ | ||
+ | |||
+ | Gsync is enabled for course 9999. The course directory owner (bob) is added to the gsync access list for the course. | ||
+ | |||
+ | **NOTE:** The instructions above assume your course is in the current term. While you can initialize gsync for a course in a different term by specifying a full path to the course directory (eg. / | ||
+ | |||
+ | ===== Step 2: Add Course TAs to Gsync Access List ===== | ||
+ | |||
+ | Add TAs to the Gsync access list for your course: | ||
+ | |||
+ | To add users: gsyncu < | ||
- | To remove users: gsyncu | + | To remove users: gsyncu < |
To list users in the access list for your course: gsyncu < | To list users in the access list for your course: gsyncu < | ||
- | **NOTE: | + | **NOTE: |
- | **NOTE:** < | + | ===== (optional) Step 3: Add Directories |
- | ===== Step 2: Wait for Your Gsync Course Account and Group to be Created ===== | + | By default, gsync will sync the " |
- | About an hour after you create the gsync user list for your course, an account and group will be automatically created. | + | To add directories: gsyncu |
- | ===== Step 3: Login to the Grading Server ===== | + | To remove directories: gsyncu < |
- | Login to the grading server (grade1.eecs.yorku.ca) with your own account. | + | To list directories that will be gsynced for your course: gsyncu < |
+ | |||
+ | **NOTE:** <dir> is relative to the course directory. | ||
+ | |||
+ | ===== Step 4: Wait for Your Gsync Account to be Initialized ===== | ||
+ | |||
+ | Gsync will create an account and group for your course (if one has not been created already). | ||
+ | |||
+ | After about an hour, gsync will have created your gsync account and group, and will have updated the gsync access list. | ||
+ | |||
+ | **NOTE:** If your course is not being taught in the current term (eg. your course is taught in 2019-20 fall, and it is presently 2018-19 summer), then your gsync account updates will only occur when your course is being taught in the present term. | ||
+ | |||
+ | ===== Step 5: Login to the Grading Server ===== | ||
+ | |||
+ | Login to the grading server (grade1.eecs.yorku.ca) with your regular EECS account. | ||
indigo% ssh grade1 | indigo% ssh grade1 | ||
Line 45: | Line 83: | ||
** NOTE: The grading server is intended to be used for grading assignments. | ** NOTE: The grading server is intended to be used for grading assignments. | ||
- | ===== Step 4: Access The Course Grading Account ===== | + | ===== Step 6: Access The Course Grading Account ===== |
- | In order to access the course grading account, use the " | + | In order to access the course grading account, use the " |
- | grade1% bu ta3311 | + | grade1% bu -d ta9999 |
Note that the grading account is only accessible from the grading server, grade1. | Note that the grading account is only accessible from the grading server, grade1. | ||
- | ===== Step 5: Sync the Course Data ===== | + | ** NOTE: You can only access |
- | After you' | + | ===== Step 7: Sync the Course Data ===== |
+ | |||
+ | After you' | ||
grade1% gsync | grade1% gsync | ||
- | The first time you run gsync, it copies down all the data from your course directory to the grading directory. | + | Here's a sample |
- | The / | + | < |
+ | Syncing ... | ||
- | / | + | Number of files: 11 (reg: 5, dir: 6) |
+ | Number of created files: 11 (reg: 5, dir: 6) | ||
+ | Number of deleted files: 0 | ||
+ | Number of regular files transferred: | ||
+ | Total file size: 76,229 bytes | ||
+ | Total transferred file size: 76,229 bytes | ||
+ | Literal data: 76,229 bytes | ||
+ | Matched data: 0 bytes | ||
+ | File list size: 0 | ||
+ | File list generation time: 0.001 seconds | ||
+ | File list transfer time: 0.000 seconds | ||
+ | Total bytes sent: 76,809 | ||
+ | Total bytes received: 154 | ||
- | ==== IMPORTANT NOTE - READ THIS TO AVOID LOSING DATA ==== | + | sent 76,809 bytes received 154 bytes 153,926.00 bytes/sec |
+ | total size is 76, | ||
- | By default, gsync will **not** overwrite data in the grading directory. This allows you and your TAs to modify files in the grading area as part of grading without the risk that running gsync again would clear their changes. If you want to allow gsync to **overwrite** files in the grading directory with files from the course directory, use the " | + | Cleaning clone tree ... |
- | grade1% gsync -o | + | Fixing file ownership/ |
- | If you want gsync to delete files and directories from the grading | + | Fixing file and directory |
- | grade1% | + | gsync complete. |
+ | </ | ||
- | Note that -o and -c options can be combined. Using both -o and -c will result | + | The first time you run gsync on the grade1 server, it copies down the data from your course submit directory, |
- | ** ATTENTION | + | The / |
+ | |||
+ | Subsequent times that you run gsync, it will will copy down changes. | ||
+ | |||
+ | Each grading account has 3 directories created: | ||
+ | |||
+ | | ||
+ | * home - the home directory for the course gsync account (You probably won't be using this directory much.) | ||
+ | * work - This directory is created for you and your TAs to do grading. | ||
+ | |||
+ | Neither you nor the TAs can create additional top-level directories in your grading | ||
+ | |||
+ | To begin grading, | ||
+ | |||
+ | < | ||
+ | grade1% cp -r / | ||
+ | </ | ||
+ | |||
+ | When you or your TAs run the gsync command, gsync will only update the " | ||
+ | |||
+ | ===== (optional) Step 8: Add a Password to Your Gsync ===== | ||
+ | |||
+ | If necessary, | ||
+ | |||
+ | Setup a password for course " | ||
+ | |||
+ | < | ||
+ | % gsyncu 9999 password | ||
+ | |||
+ | *** WARNING *** | ||
+ | |||
+ | Enabling a password on a Gsync account is possible, but discouraged. | ||
+ | Please be vigilant about who has the Gsync password for your course. | ||
+ | |||
+ | Use a blank password to disable a previously enabled Gsync password. | ||
+ | |||
+ | Enter NEW password: | ||
+ | Verify password: | ||
+ | |||
+ | A Gsync password has been set. It will be enabled within an hour. | ||
+ | </ | ||
+ | |||
+ | In order to access the account via sftp, you must sftp to grade1.eecs.yorku.ca, | ||
===== Final Notes ===== | ===== Final Notes ===== | ||
Line 89: | Line 186: | ||
* Remember that the grading account is only accessible on the grading server, grade1. | * Remember that the grading account is only accessible on the grading server, grade1. | ||
- | * gsync only copies data from the course directory to the grading area. If you want to copy data from grading area back to your course directory, | + | * gsync only copies data from the course directory to the grading area. If you want to copy data from grading area back to your course directory, |
- | grade1% | + | grade1% |
</ | </ | ||
+ | * NOTE: Only the course directory owner will be able to copy files back to the course directory. | ||
+ | * There are other options including SCPing files, SFTP, creating an archive (zip, bzip, bzip2, etc) and transferring that. | ||
+ | |||
+ | * You can only access the grading account for a course that is being offered **in the current term**. | ||
* Ugrad TAs will need to have an alternate account setup with access to grade1 before they can access the grading account. | * Ugrad TAs will need to have an alternate account setup with access to grade1 before they can access the grading account. | ||
Line 97: | Line 198: | ||
* Any use of the grading server, grade1 for any other task than grading is strictly forbidden. | * Any use of the grading server, grade1 for any other task than grading is strictly forbidden. | ||
- | * If you have any questions about gsync, please inform tech. | + | * Group submit is now reserved for faculty use **only**. |
- | + | ||
- | + | ||
+ | * If you have any questions or feedback about gsync, please inform tech. | ||
services/grading.txt · Last modified: 2021/10/01 09:00 by jas