Horde RPMs horde.README =--------------------------------------------------------------------------= $Horde: horde/packaging/redhat/horde.README,v 1.6 2001/12/24 13:00:08 bjn Exp $ NOTE: This file describes the process of installing Horde and its components on Red Hat 7.x using RPM v4 packages. - Red Hat 6.x is not yet supported. - If you are using tarballs to compile and install Horde manually, you should read the README file included in each tarball. The docs/INSTALL file in each tarball describes the complete installation process when using tarballs. INSTALLING The versions of the RPMs listed below (for Red Hat 7.x) are tested together and known to work; if you choose to use different versions, your mileage may vary. Except for PHP and MCAL, they are all official RPMs from Red Hat. The Horde RPMs require several other (prerequisite) RPMs. These RPMs can be downloaded from a Red Hat mirror such as SourceForge. For the original RPMs, append "7.x/en/os/i386/RedHat/RPMS/"; for updated RPMs, append "updates/7.x/en/os/i386/": ftp://ftp2.sourceforge.net/pub/mirrors/redhat/redhat/linux/ The following are the steps for getting these prerequisites installed. 1) Security Advisories Before you do anything else, make sure you've installed the RPMs described in the Red Hat Security Advisories for your version of Red Hat. You should update Apache, Cyrus SASL, OpenLDAP, OpenSSL, and any others that relate to the RPMs listed in this document. Some of those packages, in turn, have prerequisites that are NOT covered in this document, so consult the following: http://www.redhat.com/support/errata/ rh7-errata-security.html (7.0) rh71-errata-security.html (7.1) rh72-errata-security.html (7.2) 2) Required RPMs Since Red Hat has not yet released a suitable set of PHP 4.1.0 RPMs, nor any MCAL RPMs, Horde has created custom ones, which can be downloaded at the Horde FTP site: ftp://ftp.horde.org/pub/RPMS/i386/rh7/ a) All sites will need the following RPMs. Note especially the updated versions of freetype and libxml2 for 7.0 and 7.1; earlier versions won't work: Red Hat 7.0 and 7.1 =================== apache-1.3.22-1.7.1 freetype-2.0.1-4 (++) libxml2-2.4.2-1 (**) openssl-0.9.6-9 openssl095a-0.9.5a-9 php-4.1.0-0horde2 php-imap-4.1.0-0horde2 (++) comes from Red Hat 7.1 (**) comes from Red Hat 7.2 Red Hat 7.2 =========== apache-1.3.22-2 db31-3.1.17-1 freetype-2.0.3-7 libtool-libs13-1.3.5-2 libxml2-2.4.2-1 openssl-0.9.6b-8 openssl095a-0.9.5a-11 openssl096-0.9.6-6 php-4.1.0-0horde2 php-imap-4.1.0-0horde2 (NOTE: Red Hat went back and forth several times about whether the PHP Apache shared module (.so file) should be in its own RPM (mod_php) or not. If you were using PHP RPMs earlier than 4.0.6 check carefully to see whether there is a mod_php RPM whose version doesn't match the others. If so, uninstall it, or Apache+PHP may fail to work properly.) b) If your Horde server will also be an IMAP server: Red Hat 7.x =========== imap-2000c-10 3) OpenLDAP RPMs a) If you are using OpenLDAP with Horde: Red Hat 7.0 and 7.1 =================== openldap-2.0.11-8 openldap12-1.2.12-3 php-ldap-4.1.0-0horde2 Red Hat 7.2 =========== openldap-2.0.11-13 openldap12-1.2.12-4 php-ldap-4.1.0-0horde2 a) If your Horde server is also an OpenLDAP server: Red Hat 7.0 and 7.1 =================== openldap-servers-2.0.11-8 Red Hat 7.2 =========== openldap-servers-2.0.11-13 4) MySQL RPMs a) If you are using MySQL with Horde: Red Hat 7.0 =========== mysql-3.23.32-1.7 mysqlclient9-3.23.22-3 php-mysql-4.1.0-0horde2 Red Hat 7.1 =========== mysql-3.23.36-1 mysqlclient9-3.23.22-4 php-mysql-4.1.0-0horde2 Red Hat 7.2 =========== mysql-3.23.41-1 mysqlclient9-3.23.22-6 php-mysql-4.1.0-0horde2 a) If your Horde server is also a MySQL server: Red Hat 7.0 =========== mysql-server-3.23.32-1.7 Red Hat 7.1 =========== mysql-server-3.23.36-1 Red Hat 7.2 =========== mysql-server-3.23.41-1 5) PostgreSQL RPMs a) If you are using PostgreSQL with Horde: Red Hat 7.0 =========== php-pgsql-4.1.0-0horde2 postgresql-7.0.2-17 Red Hat 7.1 =========== php-pgsql-4.1.0-0horde2 postgresql-7.0.3-8 Red Hat 7.2 =========== php-pgsql-4.1.0-0horde2 postgresql-7.1.3-2 postgresql-libs-7.1.3-2 a) If your Horde server is also a PostgreSQL server: Red Hat 7.0 =========== postgresql-server-7.0.2-17 Red Hat 7.1 =========== postgresql-server-7.0.3-8 Red Hat 7.2 =========== postgresql-server-7.1.3-2 6) MCAL RPMs If you are using MCAL with Horde (Kronolith): Red Hat 7.x =========== mcal-0.7cvs-0horde0 php-mcal-4.1.0-0horde2 7) Horde RPMs The Horde RPMs have been VERY MINIMALLY tested with Red Hat 7.0, 7.1, and 7.2 -- additionally testing and comments welcomed. The RPMs can be downloaded from the Horde FTP site: ftp://ftp.horde.org/pub/RPMS/noarch/rh7/ Red Hat 7.x =========== horde-2.0-0RC4_1 imp-3.0-0RC4_1 kronolith-0.0.3-1 imp-1.0-0RC4_1 After installing the RPMs, you will need to configure Horde and the applications (config directories), create MySQL or PostgreSQL database tables if needed, etc. UPGRADING The Horde RPMs are designed to be upgradable (rpm -U option). As with all RPM upgrades, you should scan for .rpmorig, .rpmnew, and .rpmsave files left after the upgrade, and merge in your old configuration with the new files. A command such as the following can be used for this: # find /etc /usr /var -name \*.rpm\* -print TESTING If you want to test the Horde installation, you'll need to add read permission to /var/www/html/horde/test.php, and use a web browser to access the page at: http://example.com/horde/test.php Anything that shows up in red is a potential problem. Reload the page and make sure that the counter increments (this tests PHP session handling). ISSUES/KNOWN BUGS/MISSING FEATURES - When I get time I will be adding support for viewers (wvHtml, xlHtml, etc.) - Other minor issues are listed in horde/packaging/redhat/TODO (in CVS). CREDITS Thanks to Mike Hardy who provided some packaged versions of recent prerequisites (PHP, MCAL). Thanks to Dale Lovelace who wrote the initial Horde and IMP RPMs, and to Dan Brown who has contributed some configurability and other good ideas from his setup. CONTACT We'd love to have feedback on these RPMs; please contact us on the Horde mailing lists: http://www.horde.org/mail/ PACKAGER Brent J. Nordquist