Debian IMP Installation Guide
Copyright 1998,1999 Charles J. Hagenbuch <chuck@horde.org>
Copyright 1999 Ivan E. Moore II <rkrusty@tdyc.com>
Copyright 1999 Mike Hardy <mikeh@spark.com>
Copyright 1999 Doug Lumpkin <dougel@thecalling.net>

This code is licensed under the GNU Public License.
See the file COPYING in this directory.
Last Updated: 02/02/2000 [IEM]

+++++++++
Overview:
+++++++++

This file contains the following sections:
	  + Overview
          + Requirements for IMP
          + Installing IMP
          + Additional Notes for IMP
          

+++++++++++++
Requirements:
+++++++++++++

  ----------------
  Mandatory Items:
  ================

   * PHP 3.0.12 or greater with IMAP support 
  
   * A web server supported by PHP (Apache is most widely used)
  
   * An IMAP server to connect to.

   * Horde MUST be installed. If it is not already, please download it, and
     follow the instructions in its INSTALL file BEFORE installing IMP.

   * Perl if you want to use the manual config scripts.

   * PHPLIB 7 or greater


  ---------------
  Optional Items:
  ===============

   * An SSL Web-server so the client connection to IMP is secure
       (Apache+mod_ssl+OpenSSL is popular)

   * A database and Database support compiled into PHP if you want support
       for user preferences and addressbooks. See the DATABASE file in this
       distribution for installation and configuration instructions here.

   * LDAP support compiled into PHP if you want support for LDAP
     searches. See the file 'horde/imp/config/ldap.php3' for configuration
     instructions here.


+++++++++++++++
Installing IMP:
+++++++++++++++

  ---------------------------
  Changes for your Webserver:
  ===========================

  This piece will cover what changes to your PHP3 and Web Server
  configurations you need to make.

  ==php3.ini==

  In your php3.ini file there are a few things you need to do so that 
  content appears the way it should and also so that you can use key
  features such as IMAP.  :)

  Under the Dynamic Extensions section:

  ===Start===

  ;;;;;;;;;;;;;;;;;;;;;;
  ; Dynamic Extensions ;
  ;;;;;;;;;;;;;;;;;;;;;;
  ; if you wish to have an extension loaded automatically, use the
  ; following syntax:  extension=modulename.extension
  ; for example, on windows,
  ; extension=msql.dll
  ; or under UNIX,
  ; extension=msql.so
  ; Note that it should be the name of the module only, no directory information
  ; needs to go here.  Specify the location of the extension with the 
  ; extension_dir directive above.
  extension=imap.so      ; Added for IMAP support
  extension=mysql.so     ; Added for MySql support
  extension=pgsql.so     ; Added for PostgreSql support
  extension=ldap.so      ; Added for LDAP support

  ===End===

  You'll need to add the appropriate extensions for what you'll be using.  
  Remember that if your running this server on a Windows box you'll be using
  .dll extensions instead of .so extensions.   

  ===Apache's srm.conf===

  Now this file can look different depending on version and configuration so
  I will just show the actual line within the file that we are concerned
  with.

  DirectoryIndex index.html index.php3 index.php

  You need to make sure that index.php3 is listed in your DirectoryIndex
  line in order for IMP to show up properly. I'm sure this line is 
  called different things with different servers but the basic idea is
  that you want the index.php3 file to be a default in the same sense that
  index.html is.  index.php will be used in future release to conform
  with php4 usage.



++++++++++++++++++++++++
Additional Notes for IMP 
++++++++++++++++++++++++

  -------------------
  Apache & PHP Notes:
  ===================

  ===== Putting IMP as Apache's web-root ==========

  A lot of people would like to have IMP be Apache's web-root, so that they
  can simply specify a server and not have to type anything else in. If you
  want to do this, you need to add these lines to your httpd.conf:

  ===Start===
  DocumentRoot /usr/share/horde/imp
  Alias /horde/ /usr/share/horde/
  ===End===

  Where "/usr/share/horde/" is where ever you have installed the
  Horde package (with IMP under it).

  Note that these lines are probably already in your httpd.conf somewhere,
  and it might be best to just modify them, or add them individually in the
  location the other references to "DocumentRoot" and "Alias" are.


  ====== Using Apache's config files to handle phplib prepends ========

  # Added for HORDE
  <Directory /usr/share/horde>
  Options Indexes FollowSymLinks
  AllowOverride None
  order allow,deny
  allow from all
  php3_include_path /etc/horde:/usr/lib/phplib
  php3_auto_prepend_file /etc/horde/prepend.php3
  php3_magic_quotes_gpc Off
  </Directory>


  Adding something like the above to either Apaches httpd.conf or access.conf
  (it doesn't seem to matter which conf file it goes in anymore) will allow
  per directory loading of the required phplib files.  Otherwise if you throw
  the prepend line into your php3.ini file, these files will be loaded for
  every page that is loaded on your server which could be bad if one of the
  phplib files were to get hosed.  Doing the above limits your possible problems
  due to a mistake or bad php or whatever to just your horde web tree.

  To explain the above I'll break it down.

  The first 4 lines:

    Options Indexes FollowSymLinks
    AllowOverride None
    order allow,deny
    allow from all

  are normal Apache settings.  You can change them to whatever you want, I just
  used the defaults.

  The next 3 lines are what we need for things to work:

    php3_include_path /etc/horde:/usr/lib/phplib
    php3_auto_prepend_file /etc/horde/prepend.php3
    php3_magic_quotes_gpc Off

  the include path will have both your phplib include path, ie..where your
  core phplib files are, and the path to where you placed your horde phplib
  files.  The default location is in horde/phplib but for a Debian install,
  which is where the above lines are from, I moved all the horde config
  files into /etc/horde.  These included the files out of horde/phplib.

  So your configuration may look something like this:

  (for this example let's say your web tree is /home/httpd/html and your
  phplib files are stored in /home/httpd/phplib and your horde files are
  in /home/httpd/html/horde.  And let's say you left your horde phplib files
  where they were, in /home/httpd/html/horde/phplib)

    Your Directory config would look like this:

    <Directory /home/httpd/html/horde>
    Options Indexes FollowSymLinks
    AllowOverride None
    order allow,deny
    allow from all
    php3_include_path /home/httpd/html/horde:/home/httpd/phplib
    php3_auto_prepend_file /home/httpd/phplib/prepend.php3
    php3_magic_quotes_gpc Off
    </Directory>


  Now keep in mind you really need to read the README in the phplib directory
  of horde as there are some things you need to take care of in that prepend
  file.



