ClassWeb Installation Instructions
## configure Apache, PHP & MySQL
- install Apache, PHP & MySQL if these programs do not come pre-packaged with
your flavor of UNIX. (you might try the MAPIS shell script to do all
three at once: http://freshmeat.net/projects/mapis/)
note: default MAPis settings need to be changed to set the value of
"magic_quotes_gpc" to 0 in the PHP3 config file (/usr/local/lib/php3.ini).
Otherwise you'll get backslashes inserted before the apostrophe in names like
O'Toole.
## get Classweb
- download the ClassWeb tar.gz file from http://sourceforge.net/projects/classweb/,
if you haven't already.
## get RPL
- grab and install the RPL utility at http://www.laffeycomputer.com/rpl.html
so you can quickly change some fixed variables in classweb files.
## prepare Classweb
- determine where your web server's document root is. Many are /home/httpd/html
- tar zxf classweb_2.03.tar.gz
- cd classweb_2.03
- chown -R nobody.nobody . (or whatever user.group your web server runs as)
- set group read and write permission: chmod -R g+rw .
- change all files to reflect your document root: rpl -R "/web" "/home/httpd/html" .
- change all files to reflect YOUR domain: rpl -R "classweb.ucla.edu" "YOUR-DOMAIN.EDU" .
- mv classes classweb-docs /home/httpd/html
- mv classweb /home
- cd to /home/httpd/html/classes/registrar/phplib directory (words in {curly
braces} should be replaced with your values)
* Type: rpl -v '$dbname = "classweb";' '$dbname = "{database name}";' *
* Type: rpl -v '$username = "root";' '$username = "{username}";' *
* Type: rpl -v '$password = "";' '$password = "{password}";' *
## get Matt Wright's WWWBoard Version: 2.0A2.1 - Released: January 7, 2000
- download WWWBoard tar file from http://www.scriptarchive.com/wwwboard.html
- make sure you place this file in the classweb directory before running
wwwboard_patch file located in the classweb directory.
- Type: ./wwwboard_patch
- Change wwwboard group and owner: chgrp -R nobody.nobody wwwboard
(or whatever user.group your web server runs as)
- Change permissions: chmod -R g+rw wwwboard
## Customize
- cd /home/classweb
- edit dbopen.inc to fill in database username, pswd variables
- edit customize.inc to your choices
## create MySQL database and load test data
- cd /home/classweb
- mysqladmin -u root create {database name}
- mysql -u root -p {database name} < data/classweb.sql
## verify functionality
- in your web browser, go to http://localhost/classes
- click on the current term
- you should see one dept doorway - click on it
- you should now see the list of classes offered in that term
- click on a Course link
- click on Administration at the bottom, and use the following to get in.
Username: 1
Password: demo
- Note: If the demo username and password do not work, then you can reset
the username and password using htpasswd. The password file is
/home/classweb/security/classpass.
- check the configuration options and get familiar with class administration
- go back to http://localhost/classes and click on the WebTech link
and enter the same User/Pass info above.
- get familiar with all the WebTech tools
- go back to http://localhost/classes and click on the Registrar link
and enter the same User/Pass info above (if needed).
- review the steps required to create Classweb courses.
## set up cron entries
- add the following entries to your /var/spool/cron/root
00 05 * * * /home/classweb/bbcheckdb.pl
00 00 * * * /home/classweb/security/setgroups.pl
15 * * * * /home/classweb/statsdb.pl
45 * * * * /home/classweb/statsdb.pl
50 23 * * * /home/classweb/hits.pl
## change WebTech and Registrar passwords!
- obviously, leaving the master password for Registrar and WebTech at their
shipped values is a BAD DECISION. Go into the Administration of the demo
class and click "Other/Advanced Options". Then click Change Admin
Password. Then change the password for User-ID 1.
Last updated Wednesday, September 18, 2002