HORDE 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 Jon Parise <parise@pobox.com>

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

Last Updated: 08/10/1999 


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


 * php 3.0.12 or greater 
 * a web server, preferably an SSL web server so that HORDE Modules can use a 
     secure connection.
 * PHPLib 7 or greater
 * MySQL installed and configured so your webserver can access it (or a 
	willingness to try shared memory in PHPLib)


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

	     Either way, you will have to install PHPLib first, and that's
	a manual process.

-=-=-=
PHPLib
-=-=-=

	     These instructions are not comprehensive, and may not be *exactly*
	what you want for your site. They are known to work on a clean system
	for getting Horde and IMP running though. If you want to go beyond
	that, you will need to consult the PHPLib documentation for more
	detailed instructions.


	Installing the Files:
	---------------------

	1) Download PHPLib from http://phplib.de
	2) Unpack PHPLib in your desired installation location
	3) Go to the parent of your webserver's DocumentRoot 
		(e.g. "/home/httpd")
	4) Create a "php" directory (e.g. "/home/httpd/php")
	5) Copy the contents of the PHPLib distributions "php" directory
		into the "php" directory you created in your DocumentRoot.
	6) Copy the contents of the <horde>/phplib/ directory to your
		new "php" directory next to your DocumentRoot
	7) Rename the file "horde_phplib.inc" to "local.inc". (NOTE: if you
		already have PHPLib applications, append the contents of 
		the horde_phplib file to the local.inc file or
		you will lose your old PHPLib application settings)
	8) Edit the new "local.inc" file, and follow its directions.
		The gist of it is that you will have to uncomment the
		section of the file that applies to your PHP storage
		system, with databases being standard, and shared memory
		(SHM) as well as LDAP needing testing.

		NOTE: for shared memory to work, it must be built into PHP.
			At least in RedHat's packages, this is not the case.
            Shared memory is only available on Linux and Solaris.


	Making Necessary "php.ini" Changes:
	-----------------------------------

	1) Add the new "php" directory to your "include_path" in your php.ini
	2) Add the "prepend.php3" file in that php directory to the
		"auto_prepend_file" line in your php.ini
	3) Enable magic_quotes_gpc (change them to "On") in your php.ini


	Making Necessary "access.conf"/"httpd.conf" Changes:
	----------------------------------------------------

	1) Add "index.php3" to your "DirectoryIndex" line


	Database Changes
	----------------

	If you're using a database (like MySQL in this example), you'll
	need to do these two things:

	1) You'll need to create a "horde" database
	2) You'll need to execute the file create_database.mysql from
		the PHPLib-7 distribution against the "horde" database
		(or the file for your database if its different)

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

          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. Move the
	       directory from "horde-1.2.xx" to "horde"

               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 --help

			It will display usage instructions.

           4) In horde/config you will find a few files that you need to edit.

		The first file is "horde.php3.dist", and it needs the most work.
		Start by copying it to "horde.php3", then open it in an editor.

		Edit $default->horde_root_url, and set it to the part of the URL
		where Horde is installed, without the server name. For instance,
		If you want Horde at http://www.mikehardy.net/horde, you will
		say '/horde' here.

		If you would like to turn on our automated problem reporting
		page (users will be able to give you feedback), you should
		change $default->problem_reporting to "true;" and enter the
		email address to send reports to.

		Just as the problem reporting may be turned on, if you want
		to have automatic account signups you should change the value
		to "true;" and enter the correct email address, or implement
		a signup script in the skeleton we provide with
		<horde>/signup.php3


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



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


                Currently there are 2 types packaging out there in use.
           (there are probably more but these are the 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://snowcrash.tdyc.com/debian.php3
           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.

		There are also RPM packages maintained by Dale Lovelace 
	   <dale@redhat.com>. They are available from http://ftp.horde.org/




-=-=-=-=-=-=-
Special Notes
-=-=-=-=-=-=-


===== Putting Horde 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://faq.horde.org/. 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
three mailing lists. One is the general IMP list, for feature requests,
bug questio ns, discussion, etc. It is imp@horde.org, and you can
subscribe by sending an emp ty email to imp-subscribe@horde.org.

The second list is the developers list at dev@horde.org, and it is
targeted at people who have serious feature requests or are trying to
extend or debug IMP and other Horde modules. You may subscribe to it by
sending an empty mail to dev-subscribe@horde.org

The third list is the CVS list at cvs@horde.org, 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 HORDE development is welcome to join it by sending
email to cvs-subscribe@horde.org.

There are also web archives of all the mailing lists. See:
  http://horde.tdyc.com                                    

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

    If you have found a bug you can add it to the Bugzilla bug 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.

Enjoy,

The Horde Team
horde@horde.org
----------------------------------------------------------------------
