|
Size: 3855
Comment:
|
Size: 3967
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 14: | Line 14: |
| 1. ssh into the class account with X11 forwarding: `ssh -Y` | 1. ssh into the class account with X11 forwarding: ~+`ssh -Y`+~ |
| Line 16: | Line 16: |
| (!) sms is a tk app that requires [[http://taggi.cse.unsw.edu.au/FAQ/Accessing_CSE_login_servers/|X windows]]. Running tk app with X windows is slow. Better ways are: |
(!) sms is a [[https://www.tcl.tk/|tcl/tk]] app that requires [[http://taggi.cse.unsw.edu.au/FAQ/Accessing_CSE_login_servers/|X windows]]. Running tcl/tk app with X windows is slow. Better ways are: |
| Line 23: | Line 23: |
| `% give-install -new` | ~+`% give-install -new`+~ |
| Line 25: | Line 25: |
| `% ~give/stable/bin/give-install -new` ~- ''if ~give/stable/bin is not part of $PATH'' -~ |
~+`% ~give/stable/bin/give-install -new`+~ ''if ~+`~give/stable/bin`+~ is not part of ~+`$PATH`+~'' |
| Line 28: | Line 28: |
| `% ksh give-install -new` ~- ''if your login shell is zsh'' -~ |
~+`% ksh give-install -new`+~ ''if your login shell is zsh'' |
| Line 31: | Line 31: |
| `% give-install -new YYsN` ~- ''if the session is not the same as the system-wide session'' -~ |
~+`% give-install -new <term>`+~ ''if the term is not the same as the system-wide term'' |
| Line 35: | Line 35: |
| * Create `$WORK` (`$HOME/YYsN.work` e.g. `~/12s2.work`) * Create `give.spec` (if doesn't exists) in * `$HOME` ~-''(does not override existing one)''-~ * `$WORK` ~-''(does not override existing one)''-~ |
* Create ~+`$WORK`+~ (~+`$HOME/<term>.work`+~ e.g. ~+`~/20T3.work`+~) * Create ~+`give.spec`+~ (if doesn't exists) in * ~+`$HOME`+~ ~-''(does not override existing one)''-~ * ~+`$WORK`+~ ~-''(does not override existing one)''-~ |
| Line 40: | Line 40: |
| * Create `.giverc` in `$HOME` (overrides existing one) * Create sms database under `$WORK` (can be postponed) |
* Create ~+`.giverc`+~ in ~+`$HOME`+~ (overrides existing one) * Create sms database under ~+`$WORK`+~ (can be postponed) |
| Line 43: | Line 43: |
| * Add `$SMSDB` (e.g. `~/YYsN.work/YYsNdb.sms`) to `$HOME/.giverc` | * Add ~+`$SMSDB`+~ (e.g. ~+`~/20T3.work/20T3db.sms`+~) to ~+`$HOME/.giverc`+~ |
| Line 48: | Line 48: |
| . `% sms ~/YYsN.work/YYsNdb.sms` | . e.g. ~+`sms ~/20T3.work/20T3db.sms`+~ |
| Line 50: | Line 50: |
| . `% sms` ~- ''(if `$SMSDB` is set to the current session)'' -~ |
. ~+`sms`+~ ''if ~+`$SMSDB`+~ is set to the current term'' |
| Line 54: | Line 54: |
| `% give-install -update` | ~+`give-install -update`+~ |
| Line 59: | Line 59: |
| . For combined courses, create the database in the primary class account, add a record for each course. | . For combined courses, create the database in the primary class account, add a record for each course. |
| Line 62: | Line 62: |
| . Top menu bar: '''''Student''''' → '''''Add Student Records''''' → '''''External Source''''' . or second menu bar: '''''Add from NSS''''' |
. Top menu bar: '''''Student''''' → '''''Add Student Records''''' → '''''External Source''''' . or second menu bar: '''''Add from NSS''''' |
| Line 65: | Line 65: |
| '''''From NSS''''' or '''''From NSS (without classes)''''' The latter is used if swapping student to another class in sms. | '''''From NSS (without classes)''''' - The download will not overwrite class changes in sms |
| Line 69: | Line 69: |
| Enter this field when asked for a group field by the installation script. This field is used by give for assignment submissions. | Enter this field when asked for a group field by the ~+`give-install`+~ script. This field is used by give for assignment submissions. |
| Line 73: | Line 73: |
| 1. After installing give, update the environment to the new session: | 1. After installing give, update the give environment: |
| Line 75: | Line 75: |
| `% . ~/.giverc` | ~+`% . ~/.giverc`+~ |
| Line 77: | Line 77: |
| and insert the line above to the class account's `.profile`. | and insert the line above to the class account's `.profile`, if not already. |
| Line 79: | Line 79: |
| 1. Check that the `give.spec` file in `$HOME` contain the correct configuration for the current session. * Look out for `&period` set to a previous session. |
1. Check that the ~+`give.spec`+~ file in ~+`$HOME`+~ contain the correct configuration for the current session. * Look out for ~+`&period`+~ set to a previous session. |
| Line 82: | Line 82: |
| 1. Check the environment variables: `$GIVEPERIOD`, `$WORK`, `$SMSDB` | 1. Check the environment variables: ~+`$GIVEPERIOD`+~, ~+`$WORK`+~, ~+`$SMSDB`+~ |
| Line 84: | Line 84: |
| `% echo $GIVEPERIOD` | ~+`% echo $GIVEPERIOD`+~ |
Student Records and Assignment Management Systems
give - assignment submission, autotesting and marking system
sms - student records management system
give & sms Installation
give and sms are interconnected. Create give environment and sms database in the class account as follows:
ssh into the class account with X11 forwarding: ssh -Y
sms is a tcl/tk app that requires X windows. Running tcl/tk app with X windows is slow. Better ways are: - Run the installation script:
% give-install -new
% ~give/stable/bin/give-install -new
if ~give/stable/bin is not part of $PATH
% ksh give-install -new
if your login shell is zsh
% give-install -new <term>
if the term is not the same as the system-wide term
- The installation perform the following tasks:
Create $WORK ($HOME/<term>.work e.g. ~/20T3.work)
Create give.spec (if doesn't exists) in
$HOME (does not override existing one)
$WORK (does not override existing one)
(read about give.spec)
Create .giverc in $HOME (overrides existing one)
Create sms database under $WORK (can be postponed)
- Download student enrolment data (read about importing nss data below)
Add $SMSDB (e.g. ~/20T3.work/20T3db.sms) to $HOME/.giverc
- The installation can be paused before sms database is created.
- Create the database by running sms directly:
e.g. sms ~/20T3.work/20T3db.sms
or
sms
if $SMSDB is set to the current term
- Resume the installation with this command:
give-install -update
- Download student enrollment data
- Add course records
- For combined courses, create the database in the primary class account, add a record for each course.
- Add student records
Top menu bar: Student → Add Student Records → External Source
or second menu bar: Add from NSS
From NSS (without classes) - The download will not overwrite class changes in sms
- Add course records
- If there are classes in NSS, an enum field (tut, lab or tut_lab) will automatically be created in sms after the above downloads.
Enter this field when asked for a group field by the give-install script. This field is used by give for assignment submissions.
(Read about &subkey and &subgroup)
- After installing give, update the give environment:
% . ~/.giverc
and insert the line above to the class account's .profile, if not already.
Check that the give.spec file in $HOME contain the correct configuration for the current session.
Look out for &period set to a previous session.
Check the environment variables: $GIVEPERIOD, $WORK, $SMSDB
% echo $GIVEPERIOD