Diff for /capa/capa51/README.txt between versions 1.1 and 1.3

version 1.1, 2000/08/07 21:06:32 version 1.3, 2001/06/01 18:41:48
Line 1 Line 1
   
    Setting Up CAPA v. 5.1 For First Time Users:     Setting Up CAPA v. 5.1.5 For First Time Users:
   
   
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
   
 READ ALL INSTRUCTIONS BEFORE PRECEDING WITH THE INSTALLATION.  READ ALL INSTRUCTIONS BEFORE PRECEDING WITH THE INSTALLATION.
   
Line 29  permissions with.  Depending on your ope Line 29  permissions with.  Depending on your ope
 sizes may differ with the ones given in these instructions.  Please do  sizes may differ with the ones given in these instructions.  Please do
 not be concerned by this.  not be concerned by this.
   
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
   
 INITIAL SETUP  INITIAL SETUP
   
Line 84  group membership "cai". Line 84  group membership "cai".
   
 drwxr-xr-x    6 teacher  cai          1024 Jul 17 14:03 CAPA51  drwxr-xr-x    6 teacher  cai          1024 Jul 17 14:03 CAPA51
   
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
   
 SETTING UP THE INSTRUCTOR INTERFACE AND OPTIONAL TELNET STUDENT INTERFACE  SETTING UP THE INSTRUCTOR INTERFACE AND OPTIONAL TELNET STUDENT INTERFACE
   
Line 152  of an "x" in the user's permissions).  I Line 152  of an "x" in the user's permissions).  I
 6.)  *SKIP THIS STEP IF YOU ARE NOT ENABLING THE TELNET INTERFACE*  6.)  *SKIP THIS STEP IF YOU ARE NOT ENABLING THE TELNET INTERFACE*
 For each class that telnet is enabled for, it is added as a user  For each class that telnet is enabled for, it is added as a user
 to the system without a password.  The security of the system is  to the system without a password.  The security of the system is
 maintained by using capalogin as the login shell.  To set up the   maintained by using capalogin as the login shell.  To set up the
 demonstration class, become root then use the adduser utility to create the   demonstration class, become root then use the adduser utility to create the
 user "nsc131s0".  Enter the group id the same as the instructor (cai), the  user "nsc131s0".  Enter the group id the same as the instructor (cai), the
 parent directory to be /home/teacher/CAPA51, and the login shell   home directory to be /home/teacher/CAPA51/nsc131s0, and the login shell
 to be /home/teacher/CAPA51/capalogin.  When you are prompted to   to be /home/teacher/CAPA51/capalogin.  When you are prompted to
 enter an initial password, hit return.  You then need to edit the   enter an initial password, hit return.  You then need to edit the
 /etc/passwd file to remove the "Nologin" field.    /etc/passwd file with the vipw command to remove the "Nologin" field.
   (You may also need to edit the file /etc/shadow if your system uses
   shadow passwords.)
   
 For Linux systems, you will need to create the user, edit /etc/passwd   For Linux systems, you will need to create the user, edit /etc/passwd 
 to remove the password field, change the group id number, change the home   to remove the password field, change the group id number, change the home
 directory and change the login shell.  You will not be prompted for these   directory and change the login shell.  You will not be prompted for these
 within the utility.  Make certain the group id number is the same as the   within the utility.  Make certain the group id number is the same as the
 instructor account.  Editing the passwd file is done by becoming root  instructor account.  Editing the passwd file is done by becoming root
 using the vipw command.  Finally, you must delete the directory created by  using the vipw command.  (You may also need to edit the file /etc/shadow
 the adduser utility, for example:  if your system uses shadow passwords.)  Finally, you must delete the
   directory created by the adduser utility, for example:
   
 >rm -rf /home/nsc131s0   >rm -rf /home/nsc131s0
   
 Depending on your system, you may not be allowed to add a user without a   Depending on your system, you may not be allowed to add a user without a
 password using the adduser utility.  If this is the case, you will need  password using the adduser utility.  If this is the case, you will need
 to manually add the user with the vipw command.  to manually add the user with the vipw command.
   
 Repeat the steps above for qns131s0 and xpc131s0 (do not add xns131s0 as  Repeat the steps above for qns131s0 and xpc131s0 (do not add xns131s0 as
 a user).  a user).
   
 The correct class entries in /etc/passwd are given below: (The paths to the   The correct class entries in /etc/passwd are given below: (The paths to the
 home directory and login shell may differ for your system.)  home directory and login shell may differ for your system.)
   
 nsc131s0::1004:103:Demonstration Class - Homework:/home/teacher/CAPA51/nsc131s0:/home/teacher/CAPA51/capalogin  nsc131s0::1004:103:Demonstration Class - Homework:/home/teacher/CAPA51/nsc131s0:
 qns131s0::1005:103:Demonstration Class - Quizzes:/home/teacher/CAPA51/qsc131s0:/home/teacher/CAPA51/capalogin  /home/teacher/CAPA51/capalogin
 xpc131s0::1006:103:Demonstration Class - Exam Partial Credit:/home/teacher/CAPA51/xpc131s0:/home/teacher/CAPA51/capalogin  qns131s0::1005:103:Demonstration Class - Quizzes:/home/teacher/CAPA51/qsc131s0:/
   home/teacher/CAPA51/capalogin
   xpc131s0::1006:103:Demonstration Class - Exam Partial Credit:/home/teacher/CAPA5
   1/xpc131s0:/home/teacher/CAPA51/capalogin
   
 7.)  Login as teacher and create the class called nsc131s0 in teacher's  7.)  Login as teacher and create the class called nsc131s0 in teacher's
 CAPA51 directory.  CAPA51 directory.
Line 289  with the same permissions.  Check those Line 295  with the same permissions.  Check those
 The utilities for running CAPA with telnet sessions are now completely    The utilities for running CAPA with telnet sessions are now completely  
 installed.    installed.  
   
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
   
 SETTING UP THE WEB VERSION OF THE CAPA INTERFACE  SETTING UP THE WEB VERSION OF THE CAPA INTERFACE
   
Line 338  lrwxrwxrwx    1 teacher  cai Line 344  lrwxrwxrwx    1 teacher  cai
 lrwxrwxrwx    1 teacher  cai             7 Jul 17 15:51 getid.html -> webpage  lrwxrwxrwx    1 teacher  cai             7 Jul 17 15:51 getid.html -> webpage
 drwxr-xr-x    2 teacher  cai          1024 Jul 17 15:51 teacher  drwxr-xr-x    2 teacher  cai          1024 Jul 17 15:51 teacher
 -rw-r--r--    1 teacher  cai          4460 Jul 17 15:51 web.settings  -rw-r--r--    1 teacher  cai          4460 Jul 17 15:51 web.settings
 -rwx--x--x    1 teacher  cai       1141535 Jul 17 15:51 webpage  -rws--x--x    1 teacher  cai       1141535 Jul 17 15:51 webpage
   
 If your permissions do not match the ones above, change them so they do.  If your permissions do not match the ones above, change them so they do.
 Read step #5 before changing your permissions for capahtml.  You may   
 later see files called web_access.log and ids.log in the capa-bin   
 directory.  These files are automatically generated by the CAPA software.  
   
 5.)  If the user "teacher" does not own the webserver (for example, the  
 webserver is owned by the user "www"), then you will need to make the  
 capahtml file set UID.  
   
 > chmod u+s capahtml  > chmod u+s capahtml
   > chmod u+s webpage
   
 If "teacher" owns the webserver, then leave capahtml in the default executable  5.) You may later see files called web_access.log and ids.log in the capa-bin 
 permissions as listed in step 4.  directory.  These files are automatically generated by the CAPA software.
   
 6.)  Edit /home/teacher/PublicWeb/CAPA/capa-bin/web.settings  6.)  Edit /home/teacher/PublicWeb/CAPA/capa-bin/web.settings
 Change the first line:  Change the first line:
Line 484  http://your.machine.name/capa-bin/emaili Line 484  http://your.machine.name/capa-bin/emaili
 or http://your.machine.name/CAPA/emailid.html  or http://your.machine.name/CAPA/emailid.html
 without a previous CAPA ID.  without a previous CAPA ID.
   
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
   
 FINAL INSTRUCTIONS  FINAL INSTRUCTIONS
   
Line 524  supp_path       = /home/teacher/CAPA51/x Line 524  supp_path       = /home/teacher/CAPA51/x
 correction_path = /home/teacher/CAPA51/xpc131s0  correction_path = /home/teacher/CAPA51/xpc131s0
   
 5.)  In each of the capa.config files (DIST51/PutInCAPA51/nsc131s0/capa.config,  5.)  In each of the capa.config files (DIST51/PutInCAPA51/nsc131s0/capa.config,
 ..., ...skeleton/capa.config, etc. and /home/teacher/CAPA51/nsc131s0, etc.) edit   ..., ...skeleton/capa.config, etc. and /home/teacher/CAPA51/nsc131s0, etc.) 
 the print commands to match the ones that you use from your server where CAPA is   edit the print commands to match the ones that you use from your server where 
 installed.  The comments in the printing configuration section of the capa.config   CAPA is installed.  The comments in the printing configuration section of the 
 file will direct you how to make these changes.  capa.config file will direct you how to make these changes.
   
 Also, edit the line:  Also, edit the line:
   
Line 543  detailed list of the templates). Line 543  detailed list of the templates).
   
 8.)  Read the READMEsecurity.txt file.  8.)  Read the READMEsecurity.txt file.
   
   9.)  Make sure that the owner of the web server has /usr/local/bin as its path
 --------------------------------------------------------------------------------  or the discuss page will not work properly.  If you have trouble changing the
 --------------------------------------------------------------------------------  owner of the web server's path, put a symbolic link to /usr/local/bin/allcapaid
 --------------------------------------------------------------------------------  in /usr/bin:
   
   su -
   cd /usr/bin
   ln -s /usr/local/bin/allcapaid .
   
   -------------------------------------------------------------------------------
   -------------------------------------------------------------------------------
   -------------------------------------------------------------------------------
   
 CONTACT INFORMATION  CONTACT INFORMATION
   
Line 558  CAPA Coordinator Line 566  CAPA Coordinator
 Michigan State University  Michigan State University
 capa@capa.msu.edu  capa@capa.msu.edu
   
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
   
 ADDING ADDITIONAL USERS  ADDING ADDITIONAL USERS
   
Line 579  teacher/DIST51/CopyToPublicWeb/CAPA/capa Line 587  teacher/DIST51/CopyToPublicWeb/CAPA/capa
 instructor-name directory.  For example:  instructor-name directory.  For example:
   
 > cd /home/teacher/PublicWeb/CAPA/capa-bin/instructor-name  > cd /home/teacher/PublicWeb/CAPA/capa-bin/instructor-name
 > cp /home/DIST51/CopyToPublicWeb/CAPA/capa-bin/teacher/capasbin capasbin  > cp /home/teacher/DIST51/CopyToPublicWeb/CAPA/capa-bin/teacher/capasbin .
 > cp /home/DIST51/CopyToPublicWeb/CAPA/capa-bin/teacher/capadiscuss capadiscuss  > cp /home/teacher/DIST51/CopyToPublicWeb/CAPA/capa-bin/teacher/capadiscuss .
   
   4.)  Change the ownership of the instructor-name directory and all of its 
   files to the appropriate user ("instructor-name") and group (i.e. "cai").
   > cd /home/teacher/PublicWeb/CAPA/capa-bin
   > chown -R instructor-name:cai instructor-name
   
 Make sure that the permissions for the the capasbin and capadiscuss files   5.)  Make sure that the permissions for the the capasbin and capadiscuss files 
 are executable and that capasbin is set UID mode (there is an "s" instead   are executable and that capasbin is set UID mode (there is an "s" instead 
 of an "x" in the owner's permissions).  If not, enter the following:  of an "x" in the owner's permissions).  If not, enter the following:
   
Line 592  of an "x" in the owner's permissions). Line 605  of an "x" in the owner's permissions).
 -rwxr-xr-x    1 instructor  cai         23453 Mar 16 11:15 capadiscuss  -rwxr-xr-x    1 instructor  cai         23453 Mar 16 11:15 capadiscuss
 -rwsr-xr-x    1 instructor  cai        843150 Mar 16 11:15 capasbin  -rwsr-xr-x    1 instructor  cai        843150 Mar 16 11:15 capasbin
   
 4.)  Change the ownership of the instructor-name directory and all of its   6.)  Finally, double check that the instructor owns his/her directory
 files to the appropriate user ("instructor-name") and group (i.e. "cai").  
 > cd /home/teacher/PublicWeb/CAPA/capa-bin  
 > chown -R instructor-name:cai instructor-name  
   
 5.)  Finally, double check that the instructor owns his/her directory  
 in the capa-bin directory and that the instructor's capasbin and capadiscuss  in the capa-bin directory and that the instructor's capasbin and capadiscuss
 have the correct ownership and permissions.  have the correct ownership and permissions.
   
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
   
 ADDING ADDITIONAL CLASSES  ADDING ADDITIONAL CLASSES
   
Line 645  For Linux operating systems: Line 653  For Linux operating systems:
   
 2.)  *SKIP THIS STEP IF YOU ARE NOT ENABLING THE TELNET INTERFACE*  2.)  *SKIP THIS STEP IF YOU ARE NOT ENABLING THE TELNET INTERFACE*
 Edit the password file.  For Digital Unix and Solaris operating systems:  Edit the password file.  For Digital Unix and Solaris operating systems:
  a.) Edit the entry for "classname" in the /etc/passwd file with the vipw          a.) Edit the entry for "classname" in the /etc/passwd file with the vipw
     command.              command.
  -remove the encrypted password field (or the field "NoLogin").                   -remove the encrypted password field (or the field "NoLogin").
  -Check to be certain the home directory and login shell are                    (You may need to also edit the /etc/shadow file if using
  correct.                     shadow passwords.)
  b.) A sample /etc/passwd entry is given below:                  -Check to be certain the home directory and login shell are
                   correct.
           b.) A sample /etc/passwd entry is given below:
   
 phy123s0::1007:103:Intro Physics I:/home/instructor/CAPA51/phy123s0:/home/instructor/CAPA51/capalogin  phy123s0::1007:103:Intro Physics I:/home/instructor/CAPA51/phy123s0:/home/instru
   ctor/CAPA51/capalogin
   
 For Linux operating systems:  For Linux operating systems:
  a.) Edit the entry for "classname" in the /etc/passwd file.          a.) Edit the entry for "classname" in the /etc/passwd file.
      -Remove the encrypted password field (or the field "NoLogin").                   -Remove the encrypted password field (or the field "NoLogin").
  -Change the group id number to match the group id number in                    (You may need to also edit the /etc/shadow file if using
  the instructor's account                   shadow passwords.)
  -Change the home directory to                   -Change the group id number to match the group id number in
  /home/instructor/CAPA51                  the instructor's account
  -Change the login shell to                   -Change the home directory to
  /home/instructor/CAPA51/capalogin                  /home/instructor/CAPA51/classname
  b.) A sample /etc/passwd entry is given below:                  -Change the login shell to
                   /home/instructor/CAPA51/capalogin
           b.) A sample /etc/passwd entry is given below:
   
   phy123s0::1007:103:Intro Physics I:/home/instructor/CAPA51/phy123s0:/home/instru
   ctor/CAPA51/capalogin
   
 phy123s0::1007:103:Intro Physics I:/home/instructor/CAPA51/phy123s0:/home/instructor/CAPA51/capalogin  
   
 3.)  Make the classname directory.  Login as the "classname" owner, copy   3.)  Make the classname directory.  Login as the "classname" owner, copy 
 the contents of /home/teacher/DIST51/PutInCAPA/skeleton into the new class   the contents of /home/teacher/DIST51/PutInCAPA/skeleton into the new class 
 directory.    directory.  
Line 714  appropriate). Line 728  appropriate).
   
 Your "classname" class is now ready to use for homework.  Your "classname" class is now ready to use for homework.
   
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
   
 ADDING ACCESS FOR QUIZZES, EXAMS, EXAM PARTIAL CREDIT, ETC.  ADDING ACCESS FOR QUIZZES, EXAMS, EXAM PARTIAL CREDIT, ETC.
   
Line 763  directories.  Edit the dept_name, etc. i Line 777  directories.  Edit the dept_name, etc. i
 Also edit the classl file, making sure the instructor and TAs all belong to the   Also edit the classl file, making sure the instructor and TAs all belong to the 
 admin_section(s) (see capa.config file and edit admin_section if appropriate).  admin_section(s) (see capa.config file and edit admin_section if appropriate).
   
 --------------------------------------------------------------------------------  -------------------------------------------------------------------------------
   
   
   

Removed from v.1.1  
changed lines
  Added in v.1.3


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>