IT for all schools

File Release Notes and Changelog

Release Name: 0.5.0

Notes:
README for it4school-0.5
------------------------
(C) 2001 J. Sun <contact@it4school.com>

For further information on it4school see:
     http://www.it4school.com/


Prerequisites
-------------
LINUX libc6:
    I tested Redhat 7.0/Rawhide 1.0, and Debian woody.

Postgresql 7.1.x:
    I tested  on 7.1.0 and 7.1.1

Openldap 2.0.14

Python 2.1
   
Zope 2.4.1






Installation
------------
1. login as root.
2. untar the package:  tar xzvf it4school-0.5.tgz
3. cd into it4school-0.5
4. for the impatient,do this:  sh it4school.sh. 
   The command will generate a log file  it4school.log, and you can read it 
   if you see something wrong.
   

   notice: this may break your existing postgres and ldap installation.
   If you want to be on the safe side, or you encounter an error doing 
   the sh,  do the mannual procedures in the following. If you see the 
   success message, you are in luck! go to 11.

5. create a user called demo by doing following: 
   useradd -u 200 -g 100 demo
   mkdir /home/demo
   chown demo demo

6. change to user postgres, and add demo as a database user,  by doing this:
   su - postgres
   createuser -d demo
   exit

8. create two databases as user demo by doing following:
   su - demo
   createdb demo
   createdb web_session_demo
   cd <it4school-tar-dir>/db
   psql web_session_demo < ses.sql
   psql demo < createtable.sql
   psql demo < createview.sql
   exit

9. copy the ldap data in  by doing this:
   cd ldap
   mv /etc/ldap/ldapd.conf /etc/ldap/ldapd.conf.orig
   mv /etc/ldap/slapd.conf /etc/ldap/slapd.conf.orig
   cp *.conf /etc/ldap
   /etc/init.d/ldap restart
   /usr/sbin/ldapadd -x -D "cn=Manager,dc=ourschool,dc=ws" -f demo.ldif -p demo
   cd ..
   
10. Now you can open your netscape/mozilla browser and point to url 
    http://localhost:<your zope port>/manage to create the IT4School School Node instance.    

11. enjoy


Trouble Shooting:

1. There are several statements in it4school.sh  trying to find appropriate configuration files for different LINUX distributions. For instance, the slapd sscript was called /etc/init.d/ldap in redhat, /etc/init.d/openldapd in debian potato, and /etc/init.d/slapd in debian woody, etc.   It is helpful to follow the steps in it4school.sh for trouble shooting.

2. There are serveral products in otherProduct directory, which have been modified to work with this product. It may break you existing applications.

3. Debian woody (as of october 1, 2001) hast strict postgresql setting, you may need to modify the database connection strings to get connected.  Also, you may need to use alien to install python 2.1.





Changes:
October 1. version 0.5 released

  Setup Internationalization infrstucture.

  Move all external methods into the package.

  Major rewrite, moving IT4School to file system based  package, instead of zclass package.

June 26.  version 0.4.1 released

  bug fixes

May 14.  version 0.4 released
  

  Add initial chatroom functionality 

  Add attendance tracking functionality

  Changes in database schema.

  Fix web session related bugs
  
April 10: version 0.3.1 released

  Fix various homework workflow related bugs

March 29: version 0.3 released

  Started chat room integration

  Incoporate the message board for the teachers and students in the homework
  grading process.

  Add on-line homework grading for teachers.

  Add on-line homework hand-in for students

  Add data model for messgeboard
  
  Modify the look and feel.

March 21: version 0.2 released

  Numerous bug-fixes.
 
  Add attachment funcionality in all relevant areas. Now you can attache whaterver file in announcements, assignments,etc. Make sure have enough space for that.
 
  Incorporate LocalFS in Zope to access uploaded files from Zope.

  Add attachment related data in the data model.

  Change data model to better reflect course catalog.

March 12:  version 0.1 released.