Getting Started

Class account

Access via SSH

Have you created ssh keys? If not, create your private and public keys:
% ssh-keygen -t dsa
The public keys of authorized persons are placed in the class accounts by a batch job each night. Only people with lecturer or supervisor membership are authorized to ssh into their class accounts. The command below shows your memberships:
% acc
If acc shows that you are not a member,
- lecturers: Check that you are allocated to your course on the teaching allocations site. If not, email the academic in charge of teaching allocation (currently Jingling Xue).
- admins: Email the lecturer for your course or the academic in charge of casual tutor/admin allocations (currently Andrew Taylor) to add you to your course, as supervisor.
Log into your course account:
% ssh -Y cs9999@wagner

If you are correctly allocated to your course as indicated on the allocation files and if you have previously created your keys, you should be able to log into your class account. If not, you can email system support (ss@cse.unsw.edu.au).

Course website

A typical url for a course website: http://www.cse.unsw.edu.au/~cs9999

In the class account, under the public_html directory, create a new session directory for your files (e.g. 12s2) and edit the index.html file.

Tools for managing course websites:
- Hosted at CSE
  - WebCMS. For support, email John Shepherd
  - e.g. ENGG1811 website and /home/en1811/public_html/index.html
```
<meta http-equiv=refresh content='0;URL=http://mahler.orchestra.cse.unsw.edu.au/webcms2/course/index.php?cid=2259'>
```
  - MoinMoin Wiki. To create a wiki fill in this form or email <meicheng AT SPAMFREE cse DOT unsw DOT edu DOT au>
  - e.g. ENGG1000 website and /home/en1000/public_html/index.html
```
<meta http-equiv=refresh content='0;URL=https://wiki.cse.unsw.edu.au/en1000/12s1/'>
```
  - Moodle. CSE Courses. If you don't have permission to create a course, email <meicheng AT SPAMFREE cse DOT unsw DOT edu DOT au>
- Hosted outside CSE
  - Openlearning
  - e.g. COMP1927 website
Website contents, typically
- Notices or Announcements
- Calendar or Important dates or Schedule
- Course outline
- Classes' times and locations
- Students' allocations to classes
- Lecture slides
- Tutorial questions
- Assignment specifications
- Links to resources
- Links to past sessions (optional)

Classes

Check class utilisation regularly. Enrollments start in mid-December for continuing students and late January for first year students.
To open or close classes, increase or decrease class sizes, email <nickp AT SPAMFREE cse DOT unsw DOT edu DOT au>
How to find suitable times for new classes:
- Check your students other lecture times. There are limitations:
  - tutorials and labs aren't shown,
  - it doesn't handle streamed lectures correctly
- Check lecture and tutorial room bookings.
- For bookings, email <nickp AT SPAMFREE cse DOT unsw DOT edu DOT au>
- Check lab bookings.
- For bookings, email <meicheng AT SPAMFREE cse DOT unsw DOT edu DOT au>

Enrollments

The class accounts have read permissions to extract enrollment records. The enrollment files are stored in:

/home/sms/sturec/data
% grep COMP9999 /home/sms/sturec/data/YYsN_COMP
replacing YYsN with the current session e.g. 12s2 and COMP9999 with your course code

Tutor allocations

Andrew Taylor sends out an email in Week 0 of each session with instructions on how to select casual tutors.
- View the list of tutors at this url:
  https://www.cse.unsw.edu.au/~teachadmin/casual_academics/YYsN/summary/COMP9999.html
- Enter the tutors for your course in this file:
  /home/teachadmin/public_html/casual_academics/YYsN/selections/COMP9999
  replacing YYsN with the current session e.g. 12s2 and COMP9999 with your course code
View the list of courses and staff allocations:Teaching allocations.
Admin tools to assign tutors to classes. This application provide the following tools:
- assign tutors to classes
- generate class timetable page, link this page from your course website.
- generate tutor authorisation to Xmark and sms for pasting into $WORK/give.spec.
- generate tutor sms security configurations for pasting into $SMSDB/security.
- generate sms calc expression to identify a student's tutor.
- generate online class rolls for use by tutors.

Student Records and Assignment Management Systems

give - assignment submission, autotesting and marking system
sms - student records management system


give Manual	give FAQ	sms Manual	sms FAQ	Xmark

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:
- VNC on a CSE login server
- VLAB
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, term example 20T3
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 ($SMSDB) under $WORK (can be postponed)
- Download student enrolment data (read about importing nss data below)
- Add $SMSDB environment variable to $WORK/.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
  - using the value stored in $SMSDB
- 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
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 $HOME/give.spec contain the correct configuration for the current term.
- Look out for &period is not still set to a previous term. Example
```
&period=19T3
```
Check the environment variables: $GIVEPERIOD, $WORK, $SMSDB
% echo $GIVEPERIOD