[commits] [Wiki] changed: FAQ/Admin/Prerequisites
Jan Schneider
jan at horde.org
Thu Apr 28 12:06:33 UTC 2011
jan Thu, 28 Apr 2011 12:06:33 +0000
Modified page: http://wiki.horde.org/FAQ/Admin/Prerequisites
New Revision: 6.0
Change log: Remove old stuff, update for Horde 4
@@ -9,52 +9,20 @@
++ General prerequisites
+++ What does Horde need to run?
-Horde itself requires the following:
-
-* A web server, such as [http://www.apache.org/ Apache]
-* [http://www.php.net/ PHP].
- * Horde 2.0 requires PHP 4.1.0, or PHP 4.0.6 with a manually upgraded PEAR.
- * Horde 2.1 requires PHP 4.1.0 to 4.2.x, with at least 4.1.2 recommended
- * Horde 2.2 require version 4.1.0 or better, with 4.3.0 recommended
- * Horde 2.0 and higher require the PHP extensions gettext and xml.
- * PHP 4.2.1 and above have missing modules from PEAR, which must be
manually installed. See
[http://www.horde.org/horde/docs/?f=INSTALL.html horde/docs/INSTALL]
for more information.
- * PHP 4.2.3 has some problems with the imap routines, and may cause
problems. We recommend you not use 4.2.3
- * Horde 3.x and CVS requires version 4.3.0 or better.
- * Horde 3.0 and higher require the PHP extensions gettext, xml, and
domxml (or dom with PHP 5).
-
-Horde can use the following, although they are not required:
-
-* A secure, SSL-enabled webserver (such as Apache with
[http://www.modssl.org/ mod_ssl])
-* One of the following databases:
- * [http://www.mysql.com/ MySQL]
- * [http://www.postgresql.org/ PostgreSQL]
- * Oracle
- * MS-SQL
- * SQLite
- * Sybase
- * Informix
- * Any database supported by the [http://pear.php.net/DB PEAR DB package]
-* An LDAP directory.
-* Even more PHP extensions. See
[http://www.horde.org/horde/docs/?f=INSTALL.html horde/docs/INSTALL]
for more information.
-
-It should be noted that while a database is not technically
//required//, it is strongly recommended. Development takes place on a
systems with databases, and the majority of Horde users do the same.
-
-+++ Does Horde work with PHP 5?
-**[Horde 2.x]:** No.
+See http://www.horde.org/apps/horde/docs/INSTALL#prerequisites
++++ Does Horde work with PHP 4?
**[Horde 3.x]:** Yes.
-For a detailed answer read
[http://janschneider.de/cweb/home/index,channel,25,story,183.html this
article].
+**[Horde 4.x]:** No.
+++ How do I build Apache with PHP?
Please read the excellent [http://www.php.net/manual/en/install.php
installation manual] on the PHP website.
+++ Do I really need gettext support?
-**[Horde 1.x]:** Horde 1.x and IMP 2.x do not require gettext support.
-
-**[Horde 2.x/3.x]:** At a minimum, Horde 2.x/3.x and its applications
require gettext support in PHP. Horde **will not run** without gettext
support in php. In addition, if you wish to have the messages
translated, then you will require working gettext support in the
operating system and the desired locales installed for the languages
you want to support. Some operating system specific notes follow.
+**[Horde 3.x/4.x]:** At a minimum, Horde 3.x/4.x and its applications
require gettext support in PHP. Horde **will not run** without gettext
support in php. In addition, if you wish to have the messages
translated, then you will require working gettext support in the
operating system and the desired locales installed for the languages
you want to support. Some operating system specific notes follow.
**Debian Linux:** You can configure the locale support with the
command //dpkg-reconfigure locales//.
(In the rare case that the above command returns an error about
locales not being installed, you should use the command {{apt-get
install locales}} to install and configure the locales).
@@ -66,43 +34,25 @@
**Slackware Linux:** Make sure you have the //glibc-i18n// package
installed. Make sure in {{/etc/apache/php.ini}} you set
{{register_argc_argv = On}} (it's Off by default) and that you enable
the gettext extension by setting adding or uncommenting
{{extension=gettext.so}} also (also not enabled by default).
**!SuSE Linux:** Make sure you have the //glibc-locale// and
//php5-gettext// packages are installed. You can install them via the
//yast// configuration tool.
-**Solaris:** On Solaris 7, you must have installed the //Partial
Locales// (SUNWploc) and //Supplementary Partial Locales// (SUNWploc1)
packages. On Solaris 8, you must install the local packages required
for the locales you desire (for example, you may need to install
SUNWweuos for Western European locales or SUNWmeaos for Middle Eastern
locales). Horde assumes that the Sun Solaris gettext implementation is
in place. If you have installed the GNU gettext instead or in
addition, you may have problems. In particular you must make sure that
your web server software and php software are linked to the same
version of gettext (e.g. libintl.so). See the file
{{/horde/po/README}} for more information. (Since Horde 2.2 this
information is instead located in
{{[http://www.horde.org/horde/docs/?f=TRANSLATIONS.html
/horde/docs/TRANSLATIONS]}})
+**Solaris:** On Solaris 7, you must have installed the //Partial
Locales// (SUNWploc) and //Supplementary Partial Locales// (SUNWploc1)
packages. On Solaris 8, you must install the local packages required
for the locales you desire (for example, you may need to install
SUNWweuos for Western European locales or SUNWmeaos for Middle Eastern
locales). Horde assumes that the Sun Solaris gettext implementation is
in place. If you have installed the GNU gettext instead or in
addition, you may have problems. In particular you must make sure that
your web server software and php software are linked to the same
version of gettext (e.g. libintl.so). See the file
[http://www.horde.org/apps/horde/docs/TRANSLATIONS#solaris
horde/docs/TRANSLATIONS]) for more information.
+
+**Ubuntu:** You can install additional locales with the command
{{locale-gen de_DE.UTF-8}} (installing German locales in this
example). This command is part of the {{locales}} package that need to
be installed.
On some systems, in particular on Solaris, you will need to rebuild
the Horde locale files. You may need to restart the web server after
rebuilding the locale files in order for the web server to see the new
files.
-For more information, see the file
{{[http://www.horde.org/horde/docs/?f=TRANSLATIONS.html
/horde/docs/TRANSLATIONS]}}.
+For more information, see the file
[http://www.horde.org/apps/horde/docs/TRANSLATIONS
horde/docs/TRANSLATIONS].
++ IMP prerequisites
+++ What does IMP need to run?
-Aside from the general Horde requirements, IMP 2.2 requires:
+See http://www.horde.org/apps/imp/docs/INSTALL#prerequisites
-* A database. As with Horde, this is ostensibly optional, but major
functionality will be lost without a database and a database-enabled
PHP, including address books and user preferences.
-* The UW-IMAP c-client libraries, available as part of the
[http://www.washington.edu/imap/ UW-IMAP server package].
-* An IMAP server to connect to (which need not be on the same machine
as the webserver).
-* The PHP extension for imap must be enabled (even if using POP3).
++++ I don't use UW-IMAP. How can I build IMAP support into PHP?
+IMP up to version 4.x requires that PHP be built with IMAP support;
IMP 5.x no longer requires IMAP support in PHP.
-IMP 2.2 can use the following, although they are not required:
-
-* An LDAP server to connect to. To use LDAP for address book lookups,
you must configure PHP with the {{--with-ldap}} option.
-* Sendmail installed on the webserver.
-* Ispell, or a drop-in replacement like aspell, installed on the webserver.
-
-IMP 3.x requirements are the same as above with the following
exceptions and additions.
-
-* IMP 3.x requires Horde 2.0 or better.
-* IMP 3.x can use a remote SMTP host rather than using Sendmail
installed on the webserver.
-* IMP 3.x does not have a built-in address book, but rather uses the
[http://www.horde.org/turba/ Turba] module of Horde which can be
installed separately.
-
-IMP 4.x requirements are the same as above with the following
exceptions and additions.
-
-* IMP 4.x does not have built-in filters, but rather uses the
[http://www.horde.org/ingo/ Ingo] module of Horde which can be
installed separately.
-* See [http://www.horde.org/imp/docs/?f=INSTALL.html#prerequisites
the INSTALL file] for detailed requirements for IMP.
-
-+++ I don't use UW-IMAP. How can I build IMAP support into PHP?
-IMP requires that PHP be built with IMAP support; PHP requires that
the UW-IMAP //c-client// library be available during compilation. This
library is the reference IMAP implementation and is only an IMAP
//client//. Many distributions ship with the c-client library, often
with the package name //imap-devel//.
+PHP requires that the UW-IMAP //c-client// library be available
during compilation. This library is the reference IMAP implementation
and is only an IMAP //client//. Many distributions ship with the
c-client library, often with the package name //imap-devel//.
c-client has nothing to do with the IMAP server that you use; even
if you use the Courier or Cyrus IMAP server, you must download the
UW-IMAP package and build c-client on the same machine as the
webserver. The steps to build only the c-client libraries are as
follows:
# Move to the top directory of the UW-IMAP distribution.
@@ -112,98 +62,39 @@
+++ How can I use secure/encrypted IMAP-SSL connections?
Some IMAP servers also support IMAP-SSL, which encrypts the
connection between the client and the server so as to protect
passwords and message content which would otherwise be passed in
plaintext.
-**[IMP 2.2]:** While IMP 2.2 doesn't support IMAP-SSL directly, by
using the [http://www.stunnel.org/ stunnel] SSL-tunneling program, you
can make IMP use SSL connections; you can even use stunnel on both
ends of the connection to make IMP use an SSL connection to an IMAP
server which doesn't support SSL connections.
+**[IMP 3.x/4.x]:** If PHP is built against a recent version of
c-client and using the configuration flag {{--with-imap-ssl}}, IMP
supports IMAP-SSL and POP-SSL natively. Use {{imap/ssl}} or
{{pop/ssl}} as the protocol type in {{horde/imp/config/servers.php}}.
-The [http://www.stunnel.org/faq/examples.html#ToC6 stunnel FAQ]
explains the latter case; if your IMAP server already speaks SSL, you
only need to complete the client-side steps.
-
-**[IMP 3.x/4.x]:** If PHP is built against a recent version of
c-client and using the configuration flag {{--with-imap-ssl}}, IMP
supports IMAP-SSL and POP-SSL natively. Use {{imap/ssl}} or
{{pop/ssl}} as the protocol type in {{horde/imp/config/servers.php}}.
+**[IMP 5.x]:** You need the OpenSSL extension for PHP installed if
you want to use IMAP SSL/TLS connections.
+++ How can I use Microsoft Exchange as my IMAP server?
First, you must enable IMAP access in the Exchange Administrator.
Expand your main container, and click //Protocols//. Double-click
//IMAP4//. Check the //Enable Protocol// check box. Jason Haar also
suggests unchecking the //Enable Fast Message Retrieval// check box if
you experience problems with missing attachments. If you only want
certain users to have IMP access, you can use the Exchange
Administrator to disable IMAP for individual mailboxes.
-**[IMP 2.2]:** In {{horde/imp/config/defaults.php3}}, edit these settings:
-
-<code type="php">
-$default->folders = "";
-$default->sent_mail = "Sent Items";
-$default->postponed = "Drafts";
-</code>
-
-**[IMP 3.x/4.x]: Recent versions of IMP have an example configuration
for Exchange servers in the {{imp/config/servers.php.dist}} file.
+**[IMP 4.x/5.x]:** Recent versions of IMP have an example
configuration for Exchange servers in the
{{imp/config/servers.php.dist}} resp. {{imp/config/backends.php}} file.
For the IMP username, use {{nt_domain\nt_login_id\exchange_alias}}.
If your Exchange alias is the same as your NT login id, you may be
able to use just the Exchange alias for the IMP username. Use your NT
domain password for the IMP password.
Once logged in, you will have access to all your Exchange data,
including calendar, tasks, contacts, etc. You can use the Imp folder
management interface to subscribe and unsubscribe from these folders.
Exchange serves up everything via IMAP, and IMP will happily display
the contents of the non-email folders as if they were email messages.
As a result, they aren't terribly useful and not at all editable, but
at least you can see some detail.
+++ Can I use POP3 instead of IMAP?
-**[IMP 2.2]:** Certainly! IMP supports IMAP, POP3, and even NNTP;
just specify the appropriate protocol in
{{horde/imp/config/servers.php3}} or set
+**[IMP 4.x/5.x]:** Certainly! IMP supports IMAP and POP3; just
specify the appropriate protocol for each server in
{{horde/imp/config/servers.php}} resp.
{{horde/imp/config/backends.php}} as described in the comments at the
top of that file.
-<code type="php">
-$default->user_change_servtype = true;
-$default->user_change_port = true;
-</code>
-
-or
-
-<code type="php">
-$default->servtype = 'pop3';
-$default->port = '110';
-</code>
-
-in {{horde/imp/config/default.php3}}.
-
-**[IMP 3.x/4.x]:** Certainly! IMP supports IMAP and POP3; just
specify the appropriate protocol for each server in
{{horde/imp/config/servers.php}} as described in the comments at the
top of that file.
-
-Keep in mind that PHP will //always// have to be compiled with the
{{--with-imap}} option to {{configure}}, and built against the IMAP
c-client libraries, even if you're not going to use it with an IMAP
server.
+Keep in mind that for IMP 4 PHP will //always// have to be compiled
with the {{--with-imap}} option to {{configure}}, and built against
the IMAP c-client libraries, even if you're not going to use it with
an IMAP server.
+++ Which database should I use?
The one you already have, of course!
-Well, no, that's not exactly true. Horde supports a wide variety of
database backends. The most stable databases to use with Horde and IMP
are [http://www.mysql.com/ MySQL] and [http://www.postgresql.org/
PostgreSQL]. Since they are free (and Oracle, MS-SQL, Informix and
Sybase are not), they're the ones that get the most use by developers
and by those installing IMP who don't already have a commercial RDBMS
lying around. Choosing between !MySQL and !PostgreSQL is as much a
religious issue as a technical one; !MySQL was traditionally
considered to be faster but at the expense of robustness and providing
commercial-RDBMS features, while !PostgreSQL was traditionally
considered to suffer slightly in performance and ease of management
while being more of an enterprise-class database. Recent versions of
!PostgreSQL and !MySQL are probably of about the same performance.
!MySQL is probably more popular however due to these historical
circumstances and considerations.
+Well, no, that's not exactly true. Horde 3 supports a wide variety of
database backends. The database support in Horde 4 is more limited.
The most stable databases to use with Horde are [http://www.mysql.com/
MySQL] and [http://www.postgresql.org/ PostgreSQL]. Since they are
free (and Oracle, MS-SQL, Informix and Sybase are not), they're the
ones that get the most use by developers and by those installing IMP
who don't already have a commercial RDBMS lying around. Choosing
between !MySQL and !PostgreSQL is as much a religious issue as a
technical one; !MySQL was traditionally considered to be faster but at
the expense of robustness and providing commercial-RDBMS features,
while !PostgreSQL was traditionally considered to suffer slightly in
performance and ease of management while being more of an
enterprise-class database. Recent versions of !PostgreSQL and !MySQL
are probably of about the same performance. !MySQL is probably more
popular however due to these historical circumstances and
considerations.
-Those of you with existing Oracle, MS-SQL, Informix or Sybase
installations will be happy to know that you can use them with IMP as
well. The only disadvantage to that is that it might require a little
more work to configure, simply because it hasn't been tested to the
extent that the free databases have.
+Those of you with existing Oracle, MS-SQL, Informix or Sybase
installations will be happy to know that you can use them at least
with Horde 3 as well. The only disadvantage to that is that it might
require a little more work to configure, simply because it hasn't been
tested to the extent that the free databases have. If you need support
for one of these databases in Horde 4 too, consider
[http://www.horde.org/services sponsoring the development] of
additional database drivers for the Horde DB abstraction layer.
-+++ Can I run IMP without a database?
-**[IMP 2.2]:** You //can//, by configuring PHPlib to use shared
memory for sessions, but other database functionality such as
preferences and non-LDAP contact lists will not be available. We
strongly recommend using a database with IMP (and include everything
you need for configuring the horde database once your database
software is installed).
-
-**[IMP 3.x/4.x]:** You //can//, but database functionality such as
persistent preferences will not be available. We strongly recommend
using a database with IMP (and include everything you need for
configuring the horde database once your database software is
installed -- see the files in {{horde/scripts/db/}} or
{{horde/scripts/sql/}}).
-
-+++ Should I use wordview or wvHtml?
-Yes!
-
-Wordview and [http://wvware.sourceforge.net/ wvWare] are the old name
and the new name of the same program; the name was changed after it
was realized that there was the potential for confusion between it and
Microsoft's own "wordview".
-
-**[IMP 2.2]:** The option syntax changed between the last "wordview"
version and the first "wvHtml" version, though; if you're using a
"wordview" version, make sure you have something similar to
-
-<code type="php">
-$default->path_to_mswordview = '/usr/bin/mswordview -o -'
-</code>
-
-in your {{horde/imp/config/defaults.php3}}. If you're using wvHtml,
the above variable need only be set to the path to the program,
without the trailing arguments.
-
-**[IMP 3.x/4.x]:** IMP 3.x/4.x ships ready for wvHtml support, but
with the support disabled by default. Simply edit the file
{{horde/config/mime_drivers.php}} and uncomment the needed lines.
-
-You will need to uncomment the reference to //msword// in the
//$mime_drivers_map['horde']['registered']// array, and then uncomment
the stanza later in the file dealing with wvHtml. Last, you will need
to make sure that the path specified in the
//$mime_drivers['horde']['msword']['location']// variable is correct
for your system.
-
-Support for excel files is also available via the xlhtml, and is
configured the same was as wvHtml (substituting xlhtml for wvHtml, and
msexcel for msword were applicable).
++++ Can I run Horde without a database?
+You //can//, but database functionality such as persistent
preferences will not be available. We strongly recommend using a
database with Horde.
+++ Is Sendmail required?
-Yes and no.
-
-**[IMP 2.2]:** There's absolutely nothing at all forcing you to use
[http://www.sendmail.org/ Sendmail] proper, but IMP //does// require a
command-line program on the webserver from which it can send mail,
using the same arguments that Sendmail takes. In other words, IMP
//cannot// send mail over SMTP all by itself.
-
-If you don't need an entire mail server on the machine on which IMP
runs, you might like [ftp://metalab.unc.edu/pub/Linux/system/mail/mta/
ssmtp] or [http://em.ca/~bruceg/nullmailer/ nullmailer] which provides
a sendmail-compatible interface, but merely takes the mail and hands
it off to the SMTP server of your choice.
-
-Some mailers (like Postfix and qmail) have wrapper scripts that
accept the sendmail syntax. These programs should work with IMP as
long as the wrapper script accurately implements the sendmail syntax
and semantics.
-
-**[IMP 3.x/4.x]:** IMP 3.x/4.x can use either a local sendmail
(compatible) program, or connect to a remote SMTP gateway. So if you
have access to a remote SMTP gateway, then there is no need to install
sendmail (or equivalent) on the webserver.
+No, IMP can use either a local sendmail (compatible) program, or
connect to a remote SMTP gateway. So if you have access to a remote
SMTP gateway, then there is no need to install sendmail (or
equivalent) on the webserver.
++ Turba prerequisites
+++ What does Turba need to run?
-Aside from the general Horde requirements, Turba does not have any
real requirements. However, the following are strongly recommended and
will be needed in most cases:
-
-* SQL and/or LDAP support in PHP
-* An SQL or LDAP data store
-
+See http://www.horde.org/apps/turba/docs/INSTALL#prerequisites
More information about the commits
mailing list