=======================
OverLook requirements
=======================

1. WEB server:
    a) Apache:
        - WEB server: Apache 1.3x (htpp://www.apache.org).
	- PHP Apache module
    b) Apache2:
        - WEB server: Apache2 (htpp://www.apache.org).
	- PHP Apache2 module
2. database:
    a) PostgreSQL (http://www.postgresql.org);
	Install the database:
	    - install PostgreSQL and active it (only if you use PostgreSQL);
    b) MySQL (http://www.mysql.org);
	Install the database:
	    - install Mysql and Mysql-devel. Create the MySQL root user (only if you use MySQL):
    	    # myqsladmin --user=root password <new password>
3. IMAP server
4. PHP4
5. php4-pgsql
6. php4-cli
7. php4-pear
8. gnupg
    
========================
Installing OverLook 4.x
========================

1) Unzip overlook.xxx.tgz ina directory in your filesystem. This directory will be the root dir of yor overlook 
   installation (/home/overlook/). Set the dir privileges in reading mode for the web server user.

2) Create dir where the web server user can write files. In this directory OverLook creates its data files.
   (/var/cache/overlook/). Remember to setup this path in config.php.

3) Move /home/overlook/data in /var/cache/overlook/data;

4) Chown your web server user recursivily for /home/overlook/ and /var/cache/overlook.

5) Chmod 500 recursively /home/overlook/

6) Chmod 400 the files of /home/overlook

7) Chmod 700 the directory /var/cache/overlook/data

8) Chmod 400 the files in /var/cache/overlook/data

9) Custom the config.php as described in the file comments. Set up correctely the database configuration
   for the AdressBook and for the Calendar. The AdressBook can be work with a file or with a database
   (MySql or PostgreSQL). The Calendar works only with PostgreSQL.   

10) Custom the config_local.php file.

11) If you want to use the AdressBook on a database:
    - MySQL:
	- create the user and the database with these commands:
	    a) mysql -u root -p mysql
	    b) mysql> CREATE DATABASE <database>;
	    c) mysql> GRANT ALL PRIVILEGES ON <database>.* TO <user>@localhost IDENTIFIED BY "yourpassword" WITH GRANT OPTION;
	    d) mysqladmin -u root -p reload
	- cretate the table, views and other database stuff:
	    mysql -u <user> -p <database> < addressbook-mysql.sql
    - PostgreSQL:
	- create the user and the database with these commands:
		a) login as root
		b) insert in /var/lib/postgres/data/pg_hba.conf:
		    # OverLook
		    local   <user>  <database>                                           md5
		    host    <user>  <database>       127.0.0.1         255.0.0.0         md5
		c) enable the TCP/IP support in /var/lib/postgres/data/postgres.conf
		d) /etc/init.d/postgres stop
		e) /etc/init.d/postgres start
	        f) su postgres
		g) createlang plpgsql template1
		h) createdb <database>
		i) psql <database>
		l) psql> CREATE USER <user> ENCRYPTED PASSWORD 'yourpassword' CREATEDB NOCREATEUSER;
	- cretate the table, views and other database stuff:
	    psql -U <user> -W <database> < addressbook-psql.sql
12) If you want to use the Calendar:
    - create th euser and the database as decribed above (they can be the same of the AdressBook)
    - cretate the table, views and other database stuff:
	    psql -U <user> -W <database> < calendar-psql.sql


13) Modify the file /home/overlook/config/apacheinclude.conf and 
    insert into apache/apache2 configuration file the row:
	Include /home/overlook/config/apacheinclude.conf
    and restart apache/apache2.

14) Activate the OverCalendar Alarms:
    - change the path /home/overlook/ in cron-alarms.php if necessary;
    - insert into /etc/inittab the row:
    	    OC:235:respawn:/home/overlook/bin/cron-alarms.php
	and run:
    	    telinit q

15) Per attivare il correttore automatico e' necessario installare il programma
    aspell e le lingue delle quali si vuole avere il dizionario.
    Impostare poi i parametri riguardanti aspell presenti nel file config_local.php.
    Es: in debian per avere il correttore in italiano ed inglese
        occorre installare i seguenti pacchetti:
            aspell
            aspell-it
            aspell-en
        ed impostare in config_local.php:
            $aspell_prog = '"/usr/bin/aspell"';
            $aspell_opts_def = "-a --encoding=utf-8 -H";
            $aspell_tempfiledir = "/tmp";
            $aspell_language = 'it;en';

16) Use your OVERLOOK installation at
    http(s)://www.yourdomain.com/overlook/ 

========================