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). |
|
|
-------------------------------------------------------------------------------- |
------------------------------------------------------------------------------- |
|
|
|
|
|
|