---------------
Cyrus IMAPd RPM
---------------

This is a _very_ 'quick and dirty' install howto.

The following steps should lead you to a running Cyrus IMAP server:

1)  Install on a distribution which is supported by this RPM. Don't install
    on a dirty system, where you have previously tried to install from source.
2)  Don't install if you have a previous Cyrus IMAPd installation <=2.1.x on
    your box.
3)  Make sure you understand that this RPM installs in FHS compliant
    directories, like /var/lib/imap and /var/spool/imap
4)  Please note that this RPM uses 'basic' hashed imap spool per default.
    Fulldirhash is supported as build time option but the RPM does not
    rehash your mailspool when upgrading. You have to run rehash on
    your existing mailspool if you have changed the hashing mode.
5)  Rebuild from source RPM if the provided binaries were not built on the
    platform of your choice or you want special options built in your
    binary packages.
6)  Make sure cyrus-sasl 2.x is installed.
7)  Make sure saslauthd is running. If not, edit /etc/sysconfig/saslauthd as
    needed and do 'chkconfig saslauthd on ; service saslauthd start'
8)  Install the cyrus-imapd RPMs.
9)  If it's your first install of Cyrus IMAPd, then set a password for the
    cyrus user in whatever database you are using to authenticate.
10) Make sure your MTA delivers to Cyrus IMAPd, I recommend LMTP for this.
11) Start Cyrus IMAPd with 'service cyrus-imapd start'
12) Run cyradm and create a user. Usually it's something like this:
    'cyradm --user=cyrus --auth=login localhost'
    Note: Do a 'unset LANG' if you experience problems with special chars
    on newer RedHat distributions.
13) If you're using sendmail, be aware that cyrusv2.m4 included in standard
    sendmail distribution uses socket /var/imap/socket/lmtp while this rpm
    uses /var/lib/imap/socket/lmtp.
14) This RPM uses the 'username_tolower' feature backported from 2.2. It
    is enabled by default, which means that usernames are always converted to
    lowercase before login/autheticate. This is useful with authentication
    backends which ignore case during username lookups (suchas LDAP).

Enjoy!