This document describes the install process for the openbottle-webmail 
component.

Please Note:
  - You need to have successfully installed openbottle-core before installing
    openbottle-webmail.
  - openbottle-webmail is a set of alterations to "horde", "imp", and "turba".

20030326 Gavin Stewart <gavin@stewart.com.au>


Minimum Requirements:
RedHat 7.3
openbottle-core-0.1.1 (installed and tested)
php-4.1.2 (comes with RedHat 7.3)
php-ldap-4.1.2 (RH7.3 - make sure this rpm is installed)
php-imap-4.1.2 (RH7.3 - make sure this rpm is installed)
horde-2.1
imp-3.1
turba-1.1

The horde, imp and turba packages may be downloaded in the 
openbottle-horde-pack on sourceforge:
http://sourceforge.net/project/showfiles.php?group_id=74206

Alternatively they may be downloaded from the horde projects own web site:
http://www.horde.org

Check the relevant php rpms are installed with:
$ rpm -qa | grep ^php

If using the CVS version of openbottle-webmail, the horde directory contains
the entire patched horde+imp+turba tree.

Most people will be downloading the packaged release which contains a set
of patches for horde, imp and turba. The process for installing the packaged
release is described below.

Install horde, imp and turba from their tar archives:
- as the user "openbottle" in home directory:
- untar horde-2.1.tar.gz
- rename horde-2.1 to horde
- chdir horde
- untar imp-3.1.tar.gz in horde directory.
- rename imp-3.1 directory to imp.
- untar turba-1.1.tar.gz in horde directory.
- rename turba-1.1 to turba
to reiterate:
$ tar xzf <somepath>/horde-2.1.tar.gz
$ mv horde-2.1 horde
$ cd horde
$ tar xzf <somepath>/imp-3.1.tar.gz
$ mv imp-3.1 imp
$ tar xzf <somepath>/turba-1.1.tar.gz
$ mv turba-1.1 turba

Untar openbottle-webmail tar archive as user "openbottle" in home directory.

Patch horde tree with provided patch file:
$ chdir horde
$ patch -p1 < ../openbottle-webmail-x.x.x/patch/openbottle_horde.patch

As root:
- symlink openbottle horde directory into /var/www
# ln -s /home/openbottle/horde /var/www
- symlink openbottle html directory into /var/www/html
# ln -s /home/openbottle/openbottle-webmail-x.x.x/html/openbottle /var/www/html

- edit /etc/httpd/conf/httpd.conf
  - add horde alias line under the "<IfModule mod_alias.c>" line:
Alias /horde /var/www/horde

- Copy php.ini from openbottle-core-x.x.x/php/php.ini to /etc/php.ini
(you may want to back up the old one first.)

- edit /etc/group and add "apache" to the group "openbottle".
(This is neccessary for php to use some of the openbottle sendmail systems.)

- Restart apache after these changes are made.
# /etc/rc.d/init.d/httpd restart

Modify OpenLDAP to allow horde to store its preferences:
  - copy the supplied: openbottle-core-x.x.x/scripts/horde.schema 
    into /etc/openldap/schema/
  - edit /etc/openldap/slapd.conf and remove the comment from the start of line:
#include                /etc/openldap/schema/horde.schema
  - stop ldap: /etc/rc.d/init.d/ldap stop
  - start ldap: /etc/rc.d/init.d/ldap start

- If you have user accounts created when installing and testing openbottle-core
(example you may have the test user: test@example.com) they will need to
be updated to contain an ldap entry for horde (the webmail interface).
Run: openbottle-core-x.x.x/scripts/fix_hordeprefs.pl to update them.
After openbottle-webmail is installed, new users will automatically have
this done.

If everything went well, you should be able to point your browser toward your
openbottle machine:
http://<your.machine>/openbottle

You should be able to login with your test@example.com username and password.

Small note: The external mail fetching is not functioning, no code to handle the
fetching was included with openbottle-core-0.1.1. Future versions will have
this code (it is in CVS now, although at this time no documentation 
accompanies it).