HORDE Installation Guide
Copyright 1998,1999 Charles J. Hagenbuch <chuck@horde.org>
Copyright 1999 Ivan E. Moore II <rkrusty@tdyc.com>

This code is licensed under the GNU Public License.
See the file COPYING in this directory.

Last Updated: 04/29/99 


---------------------- 
Requirements for HORDE
======================


 * php 3.0.7 or greater 
 * a web server, preferably an SSL web server so that HORDE Modules can use a 
     secure connection.
 * PERL if you want to use the config scripts.


-------------------
Supported Languages
===================

  English
  German

-----------------------
Methods of Installation
=======================


             Currently there is one way to configure HORDE out of the box,
        and that's manually.  If you install the IMP module as well, you
        have a couple new options.  (Please see the INSTALL file that comes
        with IMP for more information).



-=-=-=-=
Manually
-=-=-=-=


              The most common method of installing HORDE is to grab the tarball,
          untar it somewhere and run through the code making all the changes 
          you need by hand.  

          Here is the process for doing all of this by hand.

           1)  obtain horde*.tar.gz 

           2)  untar/gzip it into the directory you want.

               You should now have a directory structure is like this:

                  horde/
                  horde/lib
                  horde/lib/src
                  horde/lib/src/...[lots of sub dir's]
                  horde/db
                  horde/config
                  horde/templates
                  horde/locale
                  horde/scripts
                  horde/docs

           3) go into horde/lib/src and run the following command:

                  ./build.pl

              If you install IMP as well, you can use the setup.php3 process
          that comes with it to configure the HORDE libraries as well.
       
           4) In horde/config you will find a few files.  

                [...insert config info here...]

           5) You now need to configure any modules you have installed. Please
              see their respective INSTALL files for more details.
          



-=-=-=-=
Packages
-=-=-=-=


                Packages are by far the easiest way to install any program.  
           The reason I say this is because most of the work is done for you.
           By the use of scripts the maintainer of the package take care of
           most configuration issues and the program because (most of the time)
           pretty much plug and play.   

                Currently there are 2 types packaging out there in use.
           (there are probably more but these are teh ones I know of).
           They are:  RPM (RedHat Package Management) which has a 
           .rpm extension, and Debian Package format which  has a .deb
           extension.

               There is currently a Debian package being maintained by Ivan  
           Moore II.  It is available from http://master.debian.org/~rkrusty
           and is also available within the Debian distribution.  This
           package takes care of most configuration issues and still allows you
           to customize your HORDE installation. This package also detects 
           Postgres and MySql installations and will automagically configure
           either for use with HORDE. After installing this package you will
           have a functional HORDE installation.

		Currently there is no RPM package. If you are interested in
	   maintaining one, please get in touch with us.




-----------------------
PHP3 and Apache Changes
=======================


Well, not necessarily Apache, but your Web Server in general.  This piece
will cover what changes to your PHP3 and Web Server configuration you
need to do for things to work 100% (or pretty close).  

==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.  :)

First off, under the Data Handling section:

===Start===

;;;;;;;;;;;;;;;;;
; Data Handling ;
;;;;;;;;;;;;;;;;;
magic_quotes_gpc         = Off  ; magic quotes for incoming GET/POST/Cookie data
magic_quotes_runtime     = Off  ; magic quotes for runtime-generated data
magic_quotes_sybase      = Off  ; Use Sybase-style magic quotes

===End===

Make sure all your magic_quotes options are turned OFF!

If you need magic_quotes_gpc for another PHP application, you could also let 
magic_quotes_gpc = On on your php.ini and set it off per directory bases.
Just add the following lines on your access.conf apache configuration files :

    <Directory /path/to/your/imp/directory>
    php3_magic_quotes_gpc Off
    </Directory>"


and under the Dynamic Extensions section:

===Start===

;;;;;;;;;;;;;;;;;;;;;;
; Dynamic Extensions ;
;;;;;;;;;;;;;;;;;;;;;;
; if you wish to have an extension loaded automaticly, 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.htm default.html index.cgi

You need to make sure that index.php3 is listed in your DirectoryIndex
line in order for Horde 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.  


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

A lot of people would like to have Horde 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 /home/httpd/htdocs/horde/
Alias /horde/ /home/httpd/htdocs/horde/
===End===

Where "/home/httpd/htdocs/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.



-----------------------
Getting Help with HORDE
=======================


There is an online, user-editable FAQ at http://horde.org/faq/. Use it, and
add anything that you run into to it, so that others can benefit from
everything you figure out, and vice versa...

There is a web page for HORDE at http://web.horde.org/. There are also two
mailing lists. One is the general IMP list, for development, discussion,
etc. It is imp@horde.org, and you can subscribe by sending an empty email to
imp-subscribe@horde.org.

The other list is the CVS commits list, and most of the mail on it is
automatically generated announcements of changes to the CVS code. Developers
should definitely be on it, and anyone else who is curious about the status
of IMP development is welcome to join it by sending email to
imp-cvs-subscribe@horde.org.

There are also web archives of both mailing lists. See, respectively:
  http://www.horde.org/mail/imp/
  http://www.horde.org/mail/cvs



=-=-=-=-=-=-
Found A Bug?
=-=-=-=-=-=-

    If you have found a bug you can add it to the Bug Tracking System
we have setup for the HORDE projects.  You can find it at:

http://bugs.horde.org

    Please verify that the bug is not already in the database and also
please be as descriptive as possible.  Fill out all the options.  You may
think it's something that affects everyone, but a lot of times it's 
specific to a browser or operating system.  So please be thorough.  In
the case of Bug Tracking, there is never too much information or
documentation.



----------------------------------------------------------------------
We hope you find HORDE useful and easy to use.  We thank you for taking
the time to try it and if you ever have any questions, just ask.

This version of the Installation manual was slapped together in part
by Ivan, Mike, Jason and of course, the man who started it all, the
man who keeps us on our toes, the man who'll probably never notice I
put this here but if he does I'm a dead man...Chuck.

Enjoy,

Chuck Hagenbuch and the IMP team
chuck@horde.org
----------------------------------------------------------------------
