Installation Instructions
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