POSTACI 2.0.x INSTALLATION
--------------------------

This document is for fresh installation only. If you are upgrading from a previous
version please refer to UPGRADE.
***********************************************************************************

This software is tested with real life positions but there should be at
least a few bugs. You can report any kind of bug to
Pete Larsen - pete@postaciwebmail.org

This software was developed on a Red Hat Linux system and tested with many
conditions using PostgreSQL and MySQL databases.

It uses IMAP c-client libraries which are installed when you install
php --with imap (Even though the module is called IMAP it works
for both IMAP and POP3)

Any Pentium machine should be enough for the software to work but a
P III or AMD K7 system with a minimum of 128 MB of RAM is recommended.

-------------------------------------------------------

2. Step by step Installation.
Below, is an example for PHP + IMAP + Apache installation. If you want to use another database
that Postaci supports, refer to your preferred databases' s documentation. If you need more assistance on installing PHP --with imap + Apache please see section 3.

* Set up MySQL. (http://www.mysql.org)

* Make sure you have installed php --with imap.
To see if the imap module is already installed, just type "php -m" from the command line.
If  "imap" shows up in the list then it is already installed.  You may be able to use urpmi to install the imap module.  From the command line run "urpmi php-imap".  Also, you need to make sure that register_globals is turned on in the php.ini file.  You can also turn it on using a .htaccess file.

* Setup Aspell (If you plan to use the spell check feature)
(http://aspell.sourceforge.net/)

* Setup PHP and apache. (Works with PHP 4 ot 5) (http://www.php.net)

* make sure the following lines exist in your httpd.conf file and uncommented.

* IMPORTANT!!!!
* Pay attention to the .inc extension!!!! It is a must for a secure environment.
* IMPORTANT!!!!

  AddType application/x-httpd-php .php .php3 .phtml .inc
  AddType application/x-httpd-php-source .phps

* Create a database for postaci. This can be done with the command "mysqladmin create postaci"

* make sure the database name is the same at includes/global.inc file.

* Create a temp folder for sending attachments. All the permissions should be the user nobody' This is the user which apache runs as. use the following commands...

    mkdir /tmp/postaci/
  mkdir /tmp/postaci/send/
  mkdir /tmp/postaci/store
    chown nobody.nobody -R /tmp/postaci
    chmod 770 -R /tmp/postaci

* make sure the directory is correctly specified at the includes/global.inc file.

* run the following command and create the necessary tables in the DB.

    cd queries
    mysql postaci < postaci-mysql-1.1.sql

* insert the domains you like to the tblDomains.sql file in queries folder. The syntax is as follows.

    INSERT INTO tblDomains VALUES (1,'trlinux.com');
    INSERT INTO tblDomains VALUES (2,'test.com');

* Insert the data for Domains to the DB with the following command.

    mysql postaci < tblDomains.sql

* Create a Database USER.

    $ mysql postaci
    mysql > grant usage on postaci.* to dbuser@localhost;
    mysql > grant select,insert,delete,update on postaci.* to dbuser@localhost;
    mysql > exit;
    $ mysqladmin -u dbuser password "new password"

* make sure the password is the same as "new password" in the includes/global.inc file.

* put your postaci files to a reachable directory and point your browser to that URL.

* thats all........

-----------------------------------------------------------------------------

3. Setting up your server for Postaci

    HowToForge has some excellent walk throughs for setting up any flavor of Linux.

    You just need a server that runs Apache, PHP (--with imap), and MySQL or other Database.
    You can have your POP/IMAP and SMPT servers running on a different machine if you want.

    I recommend The Perfect Mandrake/Mandriva 10.2 setup.
   

# Installing Aspell
        cd aspell-0.60.1
        ./configure && make
        make install