-----------------------------
Cyrus IMAPd Slackware Package
-----------------------------

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 clean Slackware system. 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. Upgrading any Invoca rpm based installation should be fine.
    This Slackware package is derived from the Invoca RPM for Redhat
    (see http://www.invoca.ch/pub/packages/cyrus-imapd/).
3)  Make sure you understand that this package installs in FHS compliant
    directories, like /var/lib/imap and /var/spool/imap
4)  Make sure cyrus-sasl 2.x is installed.
5)  Make sure saslauthd is running. If not, make sure that you set the script
    '/etc/rc.d/rc.saslauthd' to executable by running the command:
    "chmod +x /etc/rc.d/rc.saslauthd" followed by the command:
    "/etc/rc.d/rc.saslauthd start"
    Slackware will then take care of starting saslauthd at every boot.
6)  Install the cyrus-imapd package.
7)  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. For a
    local account, you would use the command "passwd cyrus" as root.
8)  Make sure your MTA delivers to Cyrus IMAPd, I recommend LMTP for this.
9)  Start Cyrus IMAPd with '/etc/rc.d/rc.cyrus-imapd start'. The Slackware
    package will have added that command to '/etc/rc.d/rc.local' for you, so
    that the IMAPd server starts automatically at every boot. Note: if you
    upgrade from an older version, the first start will only give you database
    version mismatch errors. So not worry, just start the rc script a second
    time. Another note: add the command '/etc/rc.d/rc.cyrus-imapd stop' to the
    file '/etc/rc.d/rc.local_shutdown', a file that you may have to create and
    set executable using 'chmod +x /etc/rc.d/rc.local_shutdown'. Doing so
    will prevent database corruption after unclean shutdown.
10) Run the command "cyradm" and create a user. Typically something like this:
    "cyradm --user=cyrus --auth=login localhost"
11) If you're using sendmail, be aware that cyrusv2.m4 included in standard
    sendmail distribution uses socket /var/imap/socket/lmtp while this package
    uses /var/lib/imap/socket/lmtp.
12) Check your syslog configuration. This package uses the 'mail' facility
    to log messages. On busy sites you may want to limit the mail facility to
    the 'info' priority with something like 'mail.info    -/var/log/maillog' in
    /etc/syslog.conf.

Enjoy!

Huge thanks to Simon Matter who created the cyrus-imapd RPM for his Invoca mail
server and whose spec file I adapted for Slackware. Visit his site at:
http://www.invoca.ch/pub/packages/cyrus-imapd/

=============================================================================
Eric Hameleers <alien@slackware.com> 01-nov-2010