[cvs] [Wiki] changed: FAQ/Admin/Install

Jan Schneider jan at horde.org
Thu May 12 16:48:15 PDT 2005


jan  Thu, 12 May 2005 16:48:15 -0700

Modified page: http://wiki.horde.org/display.php?page=FAQ%2FAdmin%2FInstall
New Revision:  1.1

@@ -1 +1,163 @@
++ Horde Administrator's FAQ
 
+++ Obtaining and Installing Horde and Components
+
+[[toc]]
+
++++ Where can I obtain Horde and its components?
+Horde, as well as any components which have seen a stable release, are available from the [ftp://ftp.horde.org/ Horde FTP site] in tar formats. Many are also available in RPM format. The following components are currently available there:
+
+* IMP
+* Turba
+* Ingo
+* Nag
+* Kronolith
+* Mnemo
+* Chora
+* Accounts
+* Forwards
+* Passwd
+* Vacation
+
+All components which have never seen a stable release are available hrough CVS. [http://www.horde.org/source/ Step-by-step directions] for obtaining them with CVS are available on the Horde website.
+
+(Please keep in mind that anything that hasn't seen a stable release hasn't seen it for a reason; while some of the components are functional at this point and may be capable of being used in production, they're still not quite ready in the eyes of the developers, and might be buggy in interesting and well-hidden ways.)
+
+Nightly snapshots of all CVS modules are also available at [http://snaps.horde.org/ Snapshot site] in tar formats. Since these are unattended, automatted snapshots they may not always be stable or even work at all. They are mostly intended for those who need the CVS code but do not have access to CVS.
+
++++ What version of Horde should I be using?
+The version of Horde that you use depends on what components you are going to be using with it. In general, any stable components will require Horde 1.2 or Horde 2.x. Anything currently only available in CVS should require Horde 1.3 or Horde 3.0. You can find out which components require which Horde versions by visiting the [http://www.horde.org/source/versions.php Horde Version Compatibility] web page.
+
+++++ What version of IMP should I be using?
+The typical site will want to install IMP 3.2.
+
+There are currently four versions of IMP available: 2.2, 3.0, and 3.1, and 3.2. (2.3 was a development version which is no longer available.) There is also a development version, not recommended for production use.
+
+3.2 is the current stable release; most installations will want this, which will maximize features, performance and stability while minimizing bugs and problems. 3.1, 3.0 and 2.2 are also quite stable and secure. The development version is a moving target, with regular updates to CVS which users are expected to keep up with in order to ensure that any potentially harmful bugs, when found, are fixed.
+
++++ Can I install Horde and its components as precompiled packages?
+On some Linux distributions, it is possible (and possibly easier) to install Horde and any of its stable components from precompiled packages.
+
+We make our own RPMs available; there is a [ftp://ftp.horde.org/pub/RPMS/noarch/rh6/horde-latest.README README for Red Hat 6.x] and a [ftp://ftp.horde.org/pub/RPMS/noarch/rh7/horde-latest.README README for Red Hat 7.x] in the RPMs directory on the Horde FTP site which explain the procedure.
+
+Debian users can install IMP through their package manager as well; the IMP packages are available in the [http://packages.debian.org/stable/web/imp.html stable distribution].
+
+++++ How can I make Debian's PHP package use IMAP-SSL?
+
+[mailto:jhealy at logn.net Jason Healy] contributed these instructions for building PHP with IMAP-SSL support. He tested them on a Debian testing system (Woody) with PHP 4.0.5-2.
+
+Find a nice quiet directory (replace /usr/local/src or your favorite source tree location:):
+
+<code>
+mkdir /usr/local/src
+cd /usr/local/src
+</code>
+
+Get the source to the PHP IMAP package (you must have {{deb-src:}} lines in your {{/etc/apt/sources.list}} for this to work)
+
+<code>
+apt-get source php4-imap
+</code>
+
+This will download and unpack the source to the php4 package.
+
+Make sure that you have all the development tools necessary to build the php4 package. A list of them can be found in {{/usr/local/src/php4_VERSION.dscM}}. Install all of those packages with {{apt-get}}. Make sure to use {{libc-client-ssl2000}} and {{libc-client-ssl2000-dev}} (in {{non-us}}) instead of plain {{libc-client}}.
+
+Move into the source tree unpacked by Debian:
+
+<code>
+cd /usr/local/src/php4-VERSION/debian
+</code>
+
+Make these two changes: in the file rules, add the line
+
+<code>
+--with-imap-ssl \ 
+</code>
+
+directly under the line
+
+<code>
+--with-imap=shared \ 
+</code>
+
+and in the file libc-client.la, change the line
+
+<code>
+dependency_libs=' -lpam -ldl -lcrypt'
+</code>
+
+to read
+
+<code>
+dependency_libs=' -lpam -ldl -lcrypt -lc-client -lssl -lcrypto'
+</code>
+
+(and in case you're wondering, the added flags are given in {{/usr/share/doc/libc-client-ssl2000-dev/README.Debian}}).
+
+Then move into the root of the unpacked source directory:
+
+<code>
+cd /usr/local/src/php4-VERSION
+</code>
+
+and build the package (the {{-us -uc}} options prevent you from trying to cryptographically sign the binaries):
+
+<code>
+dpkg-buildpackage -us -uc -rsudo
+</code>
+
+You can also use {{-rfakeroot}}, or whatever your favorite root enabler is.
+
+Wait for the compile to finish. If it doesn't work, make sure you've installed all the devel packages you need, and then start making burnt offerings.
+
+When the compile succeeds, move up to the root level of the source:
+
+<code>
+cd /usr/local/src
+</code>
+
+and then install all of the new debs that you've created. Note that you //must// install the new {{php4-VERSION.deb}} that is built, as all the modules are compiled against it. You cannot mix your newly-compiled php4 with any existing modules from the debian package system. So if you already have php4, php4-gd, and php4-imap on your system from Debian, you have to install php4, php4-gd, and php4-imap from your new source directory for everything to continue working. In the example above, you'd say (as root):
+
+<code>
+dpkg -i php4_VERSION.deb php4-imap_VERSION.deb php4-gd_VERSION.deb
+</code>
+
+Once that's all done, restart the webserver, and see if SSL works!
+
+//NOTES//: If the compile breaks, check the package dependencies in the .dsc file and make sure you have them installed correctly. Also, make sure that the flags you add to the libc-client.la file match those specified in the libc-client-ssl README.
+
+If your webserver refuses to restart, it's probably because you're mixing old and new PHP modules. You cannot just replace the IMAP module with your new compiled version; you must use your newly compiled php4 base, plus ALL the modules you compiled that match those already on your system. {{dpkg -i}} should replace the modules on your system with the newly compiled ones without causing any dependency problems.
+
++++ How do I install from CVS?
+[http://www.horde.org/source/ Step-by-step directions] for obtaining the software with CVS are available on the Horde website. In addition, please note the following issues which often come up:
+
+* When updating via CVS, it is critical that you watch for //Conflicts// as noted by the //C// flag in the output. Any conflicts must be resolved by manually editing the file.
+* When updating via CVS, make sure you check for any configuration files (config/*.php.dist or config/*.xml) which have been modified. You will need to manually merge any changes to these files into your working configuration files.
+* Before reporting an error with a CVS version of some software, make sure you have updated it so that you don't report errors which have already been fixed.
+* After some CVS updates, you may have to logout of your session, restart your browser, or even restart your web server for the changes to be seen.
+
++++ How do I upgrade via patch files?
+Upgrading from the patch files is an easy way to upgrade the code base. Note however that it is preferable to upgrade from the tar files or from CVS/rsync, as the patch files will only update the code and text files and not the binary files such as images, compiled translations, and so on.
+
+How to upgrade via the provided patch files is operating system dependent. The following directions will work for most unix based systems. Consult your operating system software documentation for additional information or for information on using patch sets for other operating systems.
+
+First, make sure you meet all the pre-requesites for the new version. See the appropriate section of this FAQ for more information.
+
+Next, download the patch file into the directory where the software resides. For Horde use your Horde directory, for IMP use your IMP directory, and so on. The following examples will use IMP as an example, and assume you have already downloaded the patch file to the imp directory.
+
+It is advisable, for various reasons, to stop your Horde web services before you do an upgrade, and restart them afterwards. While not always required, doing so may help provide a more successful upgrade.
+
+<code>
+cd imp
+gunzip patch-imp-3.1-3.2
+patch -p1 < patch-imp-3.1-3.2
+cd po
+make
+</code>
+
+As the upgrade process does not change your configuration files, but rather only operates on the *.php.dist files in the configuration directories. So you will need to manually compare your configuration files to their respective *.dist version, and merge in any changes or additions needed.
+
+Be sure to check for a file called docs/UPGRADING or docs/UPDATE for additional information such as updates to database layouts or other changes which may be needed. This file will not always exist (if no additional steps are needed when upgrading) so don't panic if it isn't there!
+
+If you shut down your web services, then restart them at this point. Even if you did not shut down your services before the upgrade, in some cases you may need to restart your web server at this point anyway.


More information about the cvs mailing list