--- capa/capa51/README.txt 2000/08/07 21:06:32 1.1 +++ capa/capa51/README.txt 2001/06/01 18:41:48 1.3 @@ -1,8 +1,8 @@ - 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. @@ -29,7 +29,7 @@ permissions with. Depending on your ope sizes may differ with the ones given in these instructions. Please do not be concerned by this. --------------------------------------------------------------------------------- +------------------------------------------------------------------------------- INITIAL SETUP @@ -84,7 +84,7 @@ group membership "cai". drwxr-xr-x 6 teacher cai 1024 Jul 17 14:03 CAPA51 --------------------------------------------------------------------------------- +------------------------------------------------------------------------------- SETTING UP THE INSTRUCTOR INTERFACE AND OPTIONAL TELNET STUDENT INTERFACE @@ -152,37 +152,43 @@ of an "x" in the user's permissions). I 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 to the system without a password. The security of the system is -maintained by using capalogin as the login shell. To set up the -demonstration class, become root then use the adduser utility to create 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 user "nsc131s0". Enter the group id the same as the instructor (cai), the -parent directory to be /home/teacher/CAPA51, and the login shell -to be /home/teacher/CAPA51/capalogin. When you are prompted to -enter an initial password, hit return. You then need to edit the -/etc/passwd file to remove the "Nologin" field. +home directory to be /home/teacher/CAPA51/nsc131s0, and the login shell +to be /home/teacher/CAPA51/capalogin. When you are prompted to +enter an initial password, hit return. You then need to edit the +/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 -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 -within the utility. Make certain the group id number is the same as the +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 +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 -using the vipw command. Finally, you must delete the directory created by -the adduser utility, for example: +using the vipw command. (You may also need to edit the file /etc/shadow +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 to manually add the user with the vipw command. Repeat the steps above for qns131s0 and xpc131s0 (do not add xns131s0 as 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.) -nsc131s0::1004:103:Demonstration Class - Homework:/home/teacher/CAPA51/nsc131s0:/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/CAPA51/xpc131s0:/home/teacher/CAPA51/capalogin +nsc131s0::1004:103:Demonstration Class - Homework:/home/teacher/CAPA51/nsc131s0: +/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 CAPA51 directory. @@ -289,7 +295,7 @@ with the same permissions. Check those The utilities for running CAPA with telnet sessions are now completely installed. --------------------------------------------------------------------------------- +------------------------------------------------------------------------------- SETTING UP THE WEB VERSION OF THE CAPA INTERFACE @@ -338,21 +344,15 @@ lrwxrwxrwx 1 teacher cai lrwxrwxrwx 1 teacher cai 7 Jul 17 15:51 getid.html -> webpage 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 --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. -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 webpage -If "teacher" owns the webserver, then leave capahtml in the default executable -permissions as listed in step 4. +5.) 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. 6.) Edit /home/teacher/PublicWeb/CAPA/capa-bin/web.settings Change the first line: @@ -484,7 +484,7 @@ http://your.machine.name/capa-bin/emaili or http://your.machine.name/CAPA/emailid.html without a previous CAPA ID. --------------------------------------------------------------------------------- +------------------------------------------------------------------------------- FINAL INSTRUCTIONS @@ -524,10 +524,10 @@ supp_path = /home/teacher/CAPA51/x correction_path = /home/teacher/CAPA51/xpc131s0 5.) In each of the capa.config files (DIST51/PutInCAPA51/nsc131s0/capa.config, -..., ...skeleton/capa.config, etc. and /home/teacher/CAPA51/nsc131s0, etc.) edit -the print commands to match the ones that you use from your server where CAPA is -installed. The comments in the printing configuration section of the capa.config -file will direct you how to make these changes. +..., ...skeleton/capa.config, etc. and /home/teacher/CAPA51/nsc131s0, etc.) +edit the print commands to match the ones that you use from your server where +CAPA is installed. The comments in the printing configuration section of the +capa.config file will direct you how to make these changes. Also, edit the line: @@ -543,10 +543,18 @@ detailed list of the templates). 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 @@ -558,9 +566,9 @@ CAPA Coordinator Michigan State University capa@capa.msu.edu --------------------------------------------------------------------------------- --------------------------------------------------------------------------------- --------------------------------------------------------------------------------- +------------------------------------------------------------------------------- +------------------------------------------------------------------------------- +------------------------------------------------------------------------------- ADDING ADDITIONAL USERS @@ -579,10 +587,15 @@ teacher/DIST51/CopyToPublicWeb/CAPA/capa instructor-name directory. For example: > cd /home/teacher/PublicWeb/CAPA/capa-bin/instructor-name -> cp /home/DIST51/CopyToPublicWeb/CAPA/capa-bin/teacher/capasbin capasbin -> cp /home/DIST51/CopyToPublicWeb/CAPA/capa-bin/teacher/capadiscuss capadiscuss +> cp /home/teacher/DIST51/CopyToPublicWeb/CAPA/capa-bin/teacher/capasbin . +> 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 of an "x" in the owner's permissions). If not, enter the following: @@ -592,16 +605,11 @@ of an "x" in the owner's permissions). -rwxr-xr-x 1 instructor cai 23453 Mar 16 11:15 capadiscuss -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 -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 +6.) Finally, double check that the instructor owns his/her directory in the capa-bin directory and that the instructor's capasbin and capadiscuss have the correct ownership and permissions. --------------------------------------------------------------------------------- +------------------------------------------------------------------------------- ADDING ADDITIONAL CLASSES @@ -645,28 +653,34 @@ For Linux operating systems: 2.) *SKIP THIS STEP IF YOU ARE NOT ENABLING THE TELNET INTERFACE* 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 - command. - -remove the encrypted password field (or the field "NoLogin"). - -Check to be certain the home directory and login shell are - correct. - b.) A sample /etc/passwd entry is given below: + a.) Edit the entry for "classname" in the /etc/passwd file with the vipw + command. + -remove the encrypted password field (or the field "NoLogin"). + (You may need to also edit the /etc/shadow file if using + shadow passwords.) + -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: - a.) Edit the entry for "classname" in the /etc/passwd file. - -Remove the encrypted password field (or the field "NoLogin"). - -Change the group id number to match the group id number in - the instructor's account - -Change the home directory to - /home/instructor/CAPA51 - -Change the login shell to - /home/instructor/CAPA51/capalogin - b.) A sample /etc/passwd entry is given below: + a.) Edit the entry for "classname" in the /etc/passwd file. + -Remove the encrypted password field (or the field "NoLogin"). + (You may need to also edit the /etc/shadow file if using + shadow passwords.) + -Change the group id number to match the group id number in + the instructor's account + -Change the home directory to + /home/instructor/CAPA51/classname + -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 the contents of /home/teacher/DIST51/PutInCAPA/skeleton into the new class directory. @@ -714,7 +728,7 @@ appropriate). Your "classname" class is now ready to use for homework. --------------------------------------------------------------------------------- +------------------------------------------------------------------------------- ADDING ACCESS FOR QUIZZES, EXAMS, EXAM PARTIAL CREDIT, ETC. @@ -763,7 +777,7 @@ directories. Edit the dept_name, etc. i 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). --------------------------------------------------------------------------------- +-------------------------------------------------------------------------------