[SVN] r506 - /trunk/cyrus-imapd-2.2.13/debian/README.Debian
debian at incase.de
debian at incase.de
Thu Jul 20 15:53:39 UTC 2006
Author: astronut
Date: Thu Jul 20 17:53:33 2006
New Revision: 506
URL: https://mail.incase.de/viewcvs?rev=506&root=cyrus22&view=rev
Log:
Partial refresh of README.Debian, more to do still
Modified:
trunk/cyrus-imapd-2.2.13/debian/README.Debian
Modified: trunk/cyrus-imapd-2.2.13/debian/README.Debian
URL: https://mail.incase.de/viewcvs/trunk/cyrus-imapd-2.2.13/debian/README.Debian?rev=506&root=cyrus22&r1=505&r2=506&view=diff
==============================================================================
--- trunk/cyrus-imapd-2.2.13/debian/README.Debian (original)
+++ trunk/cyrus-imapd-2.2.13/debian/README.Debian Thu Jul 20 17:53:33 2006
@@ -19,13 +19,12 @@
For more information, please consult http://asg.web.cmu.edu/cyrus/imapd/ and
http://asg.web.cmu.edu/twiki/bin/view/Cyrus/WebHome (Cyrus WiKi). There is
also Cyrus-HOWTO (Cyrus-IMAP.txt) available as part of the LDP HOWTO
-collection. Upgrade hints are in UPGRADE.Debian. Outdated documentation will
-cause you much grief, so beware of that when hunting anywhere else than the
-Cyrus mailinglist for information.
-
-Information about updated packages for Debian stable (i.e. of updates that
-are not necessarily security updates) is available at
-http://people.debian.org/~hmh/
+collection. Upgrade hints are in UPGRADE.Debian.gz Outdated documentation
+will cause you much grief, so beware of that when hunting anywhere else than
+the Cyrus mailinglist for information.
+
+Backports of the latest packages for Debian Stable are available from
+http://www.backports.org
WARNING: For one to get Cyrus IMAPd to work correctly, one must first get the
SASL layer to work correctly. This is far from trivial, so if you don't manage
@@ -63,15 +62,10 @@
Feel free to use dpkg-statoverride to change the permission of
/var/run/cyrus/socket, the cyrus packages will not override your
- configuration if dpkg-statoverride is used. In fact, you will most probably
+ configuration if dpkg-statoverride is used. In fact, you will most likely
have to do so for postfix to deliver to Cyrus, for example.
-3. Debian Cyrus IMAPd logs with facility MAIL instead of LOCAL6. Also, it
- prefixes *all* log output with "cyrus/" (e.g.: imapd logs appear as
- "cyrus/imapd[#####]" instead of "imapd[#####]"). This last change was
- accepted upstream for Cyrus 2.2.
-
-4. Cyrus Murder, the Cyrus IMAPd/POP3 aggregator is available.
+3. Cyrus Murder, the Cyrus IMAPd/POP3 aggregator is available.
However, you will have to configure it yourself. No pre-packaged
configuration of Murder is available at this time... The documentation is
@@ -84,20 +78,23 @@
One important note: MUPDATE doesn't support TLS, so you won't be able to
use plaintext authentication methods. The easiest thing to do is to put
- an entry for your mupdate user in sasldb2 and use DIGEST-MD5.
+ an entry for your mupdate user in sasldb2 and use DIGEST-MD5.
General notes and hints:
------------------------
o *** ALWAYS READ /usr/share/doc/cyrus-common-2.2/NEWS.Debian *** after
- you upgrade the package.
+ you upgrade the package. This, and every other NEWS.Debian can automatically
+ be shown to you before the upgrade, see the apt-listchanges package for more
+ information.
o QUOTAS ARE LIMITIED TO 2GB on some platforms.
Be careful to not set quotas over that ammount if your platform doesn't
support the C datatype "long long". Things will break in very bad ways.
Yes, it is a big glitch, and no, there are no easy workarounds.
see https://bugzilla.andrew.cmu.edu/show_bug.cgi?id=1212
+ This has been fixed for the upcoming Cyrus 2.3.
o Either turn off logging of the DEBUG level, or don't complain about cyrus
verbosity on the logs. Don't ever ask in the mailing lists about messages
@@ -106,7 +103,7 @@
o Watch out for your /dev/random bitbucket! SASL may use it, and if it
empties, it will hang the processes wrapped up by SASL. This means
just about every Cyrus service (lmtp, imap, pop3, sieve)... Disable
- APOP in /etc/imapd.conf if you don't need it, as it is a serious draw
+ APOP in /etc/imapd.conf if you don't need it, as it is a serious draw
on randomness resources.
o One extremely important point to notice is that saslauthd works ONLY
@@ -117,6 +114,10 @@
o When using ext3, Cyrus really wants data=journal. However, up to
kernel 2.4.20 there are dangerous bugs in that option, so you're better
off not using that. xfs is faster and better for Cyrus, anyway.
+ Please note that sarge was shipped with 2.4.27, and etch will not ship
+ any 2.4 kernels anymore."
+
+ 2.4 kernels are NOT shipped with Debian Etch.
o nscd users: nscd is highly incompatible with ldap, and somewhat buggy
otherwise. If you use nscd and Cyrus segfaults on you, try restarting
@@ -131,11 +132,11 @@
I didn't expect SASL 2.1 to still have this annoying problem]
o The lmtp service (allocated in Debian Woody to port 2003, and non-existent
- on Debian Sarge) is non-standard. It has no port officially allocated
- anywhere; it is usually run bound to the localhost interface, unless one
- needs it for clustering and high-availability scenarios. If you need it
- elsewhere, by all means move it -- you only need to edit /etc/services, or
- change the port for the lmtp service in /etc/cyrus.conf.
+ on Debian Sarge and Etch) is non-standard. It has no port officially
+ allocated anywhere; it is usually run bound to the localhost interface,
+ unless one needs it for clustering and high-availability scenarios. If you
+ need it elsewhere, by all means move it -- you only need to edit
+ /etc/services, or change the port for the lmtp service in /etc/cyrus.conf.
o The lmtp service will only allow Cyrus lmtp administrators to authenticate.
Set them in /etc/imapd.conf.
@@ -151,7 +152,7 @@
o One can also chose between netnews-style notation for folders
(INBOX.subfolder), where the "." character is reserved to separate folders;
or UNIX-style notation (INBOX/subfolder), where dots are allowed in names,
- and the slash separate folders (the "^" character is reserved in this
+ and the slash separate folders (the "^" character is reserved in this
mode).
See /usr/share/doc/cyrus-common-2.2/html/altnamespace.html for details.
@@ -175,23 +176,23 @@
o You need to specify your admin users in /etc/imapd.conf before you can
add mailboxes, or deliver through authenticated lmtp. Do NOT use root.
- We suggest user cyrus, which is already used by the system for all
+ We suggest user cyrus, which is already used by the system for all
things Cyrus IMAPd... but it need not be an existing user. As long as
SASL will authenticate against it, it will work.
o Do NOT read your admin user's email via IMAP (see the FAQ for details).
-
+
o Don't export your mail store over NFS or AFS (read the FAQ for more info).
You have been warned. You really want a journaled (as in journaling for the
metadata), local filesystem for the store. Failing that, you need
- something with very strict and correct lock semanthics, and full mmap
+ something with very strict and correct lock semantics, and full mmap
support.
o Ext2 is slow on very large directories (right now), and sync medatada
writes enabled are a huge performance hit. If you need high IO throughput
from Cyrus, you will need to use ext3, reiserfs, xfs or something like
that. xfs is probably the best one.
-
+
o You may want to enable/disable synchronous metadata writes to your mail
store dirs (check /usr/share/doc/cyrus-doc-2.2/html/install.html for more
info, in package cyrus-docs-2.2). The cyrus-makedirs script tries to do the
@@ -207,7 +208,7 @@
the Unix socket for that -- it automatically authenticates as user
postman and that will help wonders. cyrdeliver can also be used to
inject mail, but it will simply open an LMTP socket to cyrus and
- deliver through that -- this is much slower than using LMTP directly.
+ deliver through that -- this is much slower than using LMTP directly.
The UNIX socket is in /var/run/cyrus/socket/lmtp. Use dpkg-statoverride
if you need to change the permissions of the socket directory.
@@ -226,7 +227,7 @@
could not be started.
o If you want to run something that is not in /usr/lib/cyrus/bin in
- cyrus.conf, just use the full path in cyrus.conf (e.g.:
+ cyrus.conf, just use the full path in cyrus.conf (e.g.:
cmd="/usr/sbin/squatter").
o Sieveshell is really lacking on auth capabilities, and timsieved is quite
@@ -241,8 +242,8 @@
Known bugs
----------
- o Group lookups in LDAP (through nss-ldap) will not work well. See Debian
- bug #156671.
+ Please see http://bugs.debian.org/cgi-bin/pkgreport.cgi?which=src&data=cyrus-imapd-2.2&archive=no&version=
+ for a list of any known bugs.
SNMP logging
@@ -282,7 +283,7 @@
Loss of the delivery database is not very bad, it just means some users might
get duplicated messages.
-Cyrus does NOT backup the mail store automatically. To backup the mail store
+Cyrus does NOT backup the mail store automatically. To backup the mail store
partitions, you must stop Cyrus and dump the entire partition to your backup
media. The MH-like structure of the Cyrus store do make them suitable for
incremental backups. Hot-backups of the store can be made, but you risk losing
@@ -305,8 +306,7 @@
There aren't many. Patchset numbers as provided by the cvsps utility in its
default configuration are used to denote patches taken from upstream CVS in the
-changelog. Less important patches from upstream CVS (such as documentation
-updates) are applied without adding a changelog entry.
+changelog.
THANKS
@@ -318,7 +318,8 @@
David D. Kilzer <ddkilzer at theracingworld.com> for their huge help in getting
the v2.1 packages out-of-the-door, and the upgrade from v1.5 guide; Fabian
Fagerholm <fabbe at paniq.net> for stress testing the daemons, and useful
-feedback; and Gilles Bouthenot <gilles.bouthenot at fcomte.iufm.fr> for good
-feedback.
-
- -- Henrique de Moraes Holschuh <hmh at debian.org>
+feedback; Gilles Bouthenot <gilles.bouthenot at fcomte.iufm.fr> for good
+feedback; and Henrique de Moraes Holschuh for maintaining the 2.1 branch
+
+ -- The Debian Cyrus Team <pkg-cyrus-imapd-debian-devel at lists.alioth.debian.org>
+
More information about the Pkg-Cyrus-imapd-Debian-devel
mailing list