[Summary view] [Print] [Text view]

   1  =======================
   2  OverLook requirements
   3  =======================
   4  
   5  1. WEB server:
   6      a) Apache:
   7          - WEB server: Apache 1.3x (htpp://www.apache.org).
   8      - PHP Apache module
   9      b) Apache2:
  10          - WEB server: Apache2 (htpp://www.apache.org).
  11      - PHP Apache2 module
  12  2. database:
  13      a) PostgreSQL (http://www.postgresql.org);
  14      Install the database:
  15          - install PostgreSQL and active it (only if you use PostgreSQL);
  16      b) MySQL (http://www.mysql.org);
  17      Install the database:
  18          - install Mysql and Mysql-devel. Create the MySQL root user (only if you use MySQL):
  19              # myqsladmin --user=root password <new password>
  20  3. IMAP server
  21  4. PHP4
  22  5. php4-pgsql
  23  6. php4-cli
  24  7. php4-pear
  25  8. gnupg
  26      
  27  ========================
  28  Installing OverLook 4.x
  29  ========================
  30  
  31  1) Unzip overlook.xxx.tgz ina directory in your filesystem. This directory will be the root dir of yor overlook 
  32     installation (/home/overlook/). Set the dir privileges in reading mode for the web server user.
  33  
  34  2) Create dir where the web server user can write files. In this directory OverLook creates its data files.
  35     (/var/cache/overlook/). Remember to setup this path in config.php.
  36  
  37  3) Move /home/overlook/data in /var/cache/overlook/data;
  38  
  39  4) Chown your web server user recursivily for /home/overlook/ and /var/cache/overlook.
  40  
  41  5) Chmod 500 recursively /home/overlook/
  42  
  43  6) Chmod 400 the files of /home/overlook
  44  
  45  7) Chmod 700 the directory /var/cache/overlook/data
  46  
  47  8) Chmod 400 the files in /var/cache/overlook/data
  48  
  49  9) Custom the config.php as described in the file comments. Set up correctely the database configuration
  50     for the AdressBook and for the Calendar. The AdressBook can be work with a file or with a database
  51     (MySql or PostgreSQL). The Calendar works only with PostgreSQL.   
  52  
  53  10) Custom the config_local.php file.
  54  
  55  11) If you want to use the AdressBook on a database:
  56      - MySQL:
  57      - create the user and the database with these commands:
  58          a) mysql -u root -p mysql
  59          b) mysql> CREATE DATABASE <database>;
  60          c) mysql> GRANT ALL PRIVILEGES ON <database>.* TO <user>@localhost IDENTIFIED BY "yourpassword" WITH GRANT OPTION;
  61          d) mysqladmin -u root -p reload
  62      - cretate the table, views and other database stuff:
  63          mysql -u <user> -p <database> < addressbook-mysql.sql
  64      - PostgreSQL:
  65      - create the user and the database with these commands:
  66          a) login as root
  67          b) insert in /var/lib/postgres/data/pg_hba.conf:
  68              # OverLook
  69              local   <user>  <database>                                           md5
  70              host    <user>  <database>       127.0.0.1         255.0.0.0         md5
  71          c) enable the TCP/IP support in /var/lib/postgres/data/postgres.conf
  72          d) /etc/init.d/postgres stop
  73          e) /etc/init.d/postgres start
  74              f) su postgres
  75          g) createlang plpgsql template1
  76          h) createdb <database>
  77          i) psql <database>
  78          l) psql> CREATE USER <user> ENCRYPTED PASSWORD 'yourpassword' CREATEDB NOCREATEUSER;
  79      - cretate the table, views and other database stuff:
  80          psql -U <user> -W <database> < addressbook-psql.sql
  81  12) If you want to use the Calendar:
  82      - create th euser and the database as decribed above (they can be the same of the AdressBook)
  83      - cretate the table, views and other database stuff:
  84          psql -U <user> -W <database> < calendar-psql.sql
  85  
  86  
  87  13) Modify the file /home/overlook/config/apacheinclude.conf and 
  88      insert into apache/apache2 configuration file the row:
  89      Include /home/overlook/config/apacheinclude.conf
  90      and restart apache/apache2.
  91  
  92  14) Activate the OverCalendar Alarms:
  93      - change the path /home/overlook/ in cron-alarms.php if necessary;
  94      - insert into /etc/inittab the row:
  95              OC:235:respawn:/home/overlook/bin/cron-alarms.php
  96      and run:
  97              telinit q
  98  
  99  15) Per attivare il correttore automatico e' necessario installare il programma
 100      aspell e le lingue delle quali si vuole avere il dizionario.
 101      Impostare poi i parametri riguardanti aspell presenti nel file config_local.php.
 102      Es: in debian per avere il correttore in italiano ed inglese
 103          occorre installare i seguenti pacchetti:
 104              aspell
 105              aspell-it
 106              aspell-en
 107          ed impostare in config_local.php:
 108              $aspell_prog = '"/usr/bin/aspell"';
 109              $aspell_opts_def = "-a --encoding=utf-8 -H";
 110              $aspell_tempfiledir = "/tmp";
 111              $aspell_language = 'it;en';
 112  
 113  16) Use your OVERLOOK installation at
 114      http(s)://www.yourdomain.com/overlook/ 
 115  
 116  ========================