Contents

• Contents

• Introduction:

• Time-Line:

• Preparation:

• Course Setup:

The following instructions detail how to set-up a WeBWorK course at the University of Utah. This set-up differs from the general set-up instructions detailed in the WeBWorK documentation. For each course, there are two directories/web-pages, one for the students and one for course development. It is recommended that all course material is created in the development directory and once it has been tested/debugged, it is moved to the student directory.





Contents

In order for WeBWorK to be smoothly integrated into the classroom, it is recommended that WeBWorK is setup according to the following schedule:

1. Before the end of the preceding semester:


• Send an email to department advertising WeBWorK for the next semester
• Compile a list of all courses that plan to use WeBWorK.
• Build the WW-Online home page.


2. At the end of the preceding semester:


• Submit the course list to Pieter Bowman. Pieter builds the student and development directories, as well as URL links.


3. During the semester break:


• Assign a WeBWorK administrator to each course.
• Build the development directory for each course.
• Contact the course instructor: arrange a date and time for the in class demo, assign a homework due date and request instructions for building the first homework.
• Build the first homework set in the development directory.
• Modify the "New Account" webpage and notify Pieter Bowman of changes to the instructor list.


4. On the first day of class:


• Pieter Bowman will download the course roll for each WeBWorK course.


5. During the first two weeks of class:


• Build the student directory for each course.
• Print the student letters for each course.
• Give an in-class demo of the WeBWorK system.


6. After the in-class demo:


• Add students to the course as directed.


7. At the end of the semester:


• Archive all homework sets in the "math.utah.edu_problem_archive".
• Make .ps and .pdf files for all homework sets and update the "Hard copies of problem banks".

The following items should be done before any of the development directories are built.

Note that the WeBWorK system is installed on two servers and all information for a course will reside on one or the other. The two servers are:

WeBWorK server 1: house.math.utah.edu
WeBWorK server 2: deepcreek.math.utah.edu

The directory

/ww/webwork/courses/course-template

should be the same on both servers, with the exception of the "notify.java" file in the directories

/ww/webwork/courses/course-template/templates/letters

In this file, the URL for the course directory is set to "webwork1.math.utah.edu" or "webwork2.math.utah.edu", depending on the server.

Do the following items (on both servers):

1. Update the file "admin_database.txt":


• Change to the following directory:
  
  cd /ww/webwork/courses/course-template
  
  
• Follow the existing format and add/remove the current administrators to the file.



2. Update the setup script "WeBWorK_setup.sh":


• Change to the directory
  
  cd /ww/webwork/courses/course-template
  
  
• In the script, find the line of code
  
  # There is a bug in this code...
  
  
• Add/Remove the names from the admin_database to the next line:
  
  prof_list=$prof_list'robbins chu ylee alfeld sim'
  
  

To set up the development and course directories, run the setup script and follow the directions. Note, the script will ask for the First/Last name, id and login for the course instructor. You will need to enter this information for the course instructor and TA's, but DO NOT ENTER the course administrators! (It will be added from the "administrator_database".)

Note, when assigning an ID for the instructor/TA, use a random sequence of letters and numbers!

To run the script:

1. Login to the correct server.



2. Change to the directory:
   
   cd /ww/webwork/courses/course-template



3. Enter the following command and follow the instructions:


./WeBWorK_setup.sh

1. Change to the course directory:


cd /ww/webwork/courses/math####XXXX200#-#(-Dev)


2. Modify the "webworkCourse.ph" file:
   
   
   • Uncomment the following line (I.E., remove the leading "#") and change the email addresses those of the insturctor's, TA's and administrator's:
     
     # $Global::feedbackAddress = 'apizer@math.rochester.edu,gage@math.rochester.edu';
     
     
   • Uncomment the following line (I.E., remove the leading "#") and change the email address that of the administrator:
     
     # $Global::smtpSender = 'apizer@math.rochester.edu';
     
     
   • Uncomment the following line (I.E., remove the leading "#") and change the email addresses those of the insturctor's, TA's, administrator's and ww@math.utah.edu:
     
     # $PG_environment{'ALLOW_MAIL_TO'} = ['apizer@math.rochester.edu','gage@math.rochester.edu'];
     
     
   • Uncomment the following line (I.E., remove the leading "#") and change the user names those of the insturctor's, TA's and administrator's:
     
     #$PG_environment{'PRINT_FILE_NAMES_FOR'} = ['leeza','apizer','gage'];
     
     
3. Modify the "paperSetHeader.pg" file:
   
   
   • Change to the templates directory for the current course:
     
     cd /ww/webwork/courses/math####XXXX200#-#(-Dev)/templates
     
     
   • Update the course/section/semester and year at the top of the file:
     
     \noindent {\large \bf WW${US}Prob${US}Lib1 Math course-section, semester year}
     
     
4. Login to the system and build the demo set.



5. If this is the development directory, login and send the default message to the class. This will notify the instructor and TAs how to login.



6. If this is the course directory, generate the login instructions for the students.
   
   
   • Change to the letters directory for the current course:
     
     cd /ww/webwork/courses/math####XXXX200#-#/templates/letters
     
     
   • Generate the .tex file by entering the following command:
     
     java notify math####XXXX200#-#
     
     
   • Tex the .tex file by entering the following command:
     
     tex math####XXXX200#-#.tex
     
     Note, if there are errors in the .tex file due to the student email, try replacing all "_" with "\_" in the .tex file and re-Tex the file.
     
     
   • Generate a postscript file by entering the following command:
     
     dvips -o math####XXXX200#-#.ps math####XXXX200#-#.dvi
     
     
   • Print the .ps file.