| 1 |
Red Hat Enterprise Linux |
| 2 |
======================== |
| 3 |
|
| 4 |
Red Hat Enterprise Linux ships Cyrus IMAP packages as part of the base |
| 5 |
operating system repositories. If the base operating system has a |
| 6 |
subscription activated, then `Red Hat, Inc.`_ supports the package |
| 7 |
through the usual support channels. |
| 8 |
|
| 9 |
Currently supported versions of Red Hat Enterprise Linux include |
| 10 |
Cyrus IMAP packages in the repositories configured on a stock system: |
| 11 |
|
| 12 |
* Cyrus IMAP |imap_tikanga_stock_version| for Red Hat Enterprise Linux |
| 13 |
5 |
| 14 |
|
| 15 |
* Cyrus IMAP |imap_santiago_stock_version| for Red Hat Enterprise |
| 16 |
Linux 6 |
| 17 |
|
| 18 |
* Cyrus IMAP |imap_maipo_stock_version| for Red Hat Enterprise Linux 7 |
| 19 |
|
| 20 |
.. NOTE:: |
| 21 |
|
| 22 |
The Cyrus project does not support running any versions of the Cyrus |
| 23 |
IMAP software older than the version of the software shipped |
| 24 |
with the operating system itself. |
| 25 |
|
| 26 |
To install the version of Cyrus IMAP that comes with the operating |
| 27 |
system, issue the following command: |
| 28 |
|
| 29 |
.. parsed-literal:: |
| 30 |
|
| 31 |
# :command:`yum install cyrus-imapd cyrus-sasl cyrus-sasl-plain` |
| 32 |
|
| 33 |
Next, set a password for the default administrative user ``cyrus``: |
| 34 |
|
| 35 |
.. parsed-literal:: |
| 36 |
|
| 37 |
# :command:`passwd cyrus` |
| 38 |
Changing password for user cyrus. |
| 39 |
New password: |
| 40 |
Retype new password: |
| 41 |
passwd: all authentication tokens updated successfully. |
| 42 |
|
| 43 |
Start and configure to start when the system boots, the |
| 44 |
:manpage:`saslauthd` service: |
| 45 |
|
| 46 |
.. parsed-literal:: |
| 47 |
|
| 48 |
# :command:`service saslauthd start` |
| 49 |
Starting saslauthd: [ OK ] |
| 50 |
# :command:`chkconfig saslauthd on` |
| 51 |
|
| 52 |
You should at this moment be able to authenticate against |
| 53 |
:manpage:`saslauthd`: |
| 54 |
|
| 55 |
.. parsed-literal:: |
| 56 |
|
| 57 |
# :command:`testsaslauthd -u cyrus -p YOUR-PASSWORD` |
| 58 |
|
| 59 |
|
| 60 |
You should get an ``0: OK "Success."`` message. |
| 61 |
|
| 62 |
.. todo:: If this does not succeed, see ref `sasl-troubleshooting-saslauthd`. |
| 63 |
|
| 64 |
Start the service, and ensure the service starts up when the system |
| 65 |
boots: |
| 66 |
|
| 67 |
.. parsed-literal:: |
| 68 |
|
| 69 |
# :command:`service cyrus-imapd start` |
| 70 |
# :command:`chkconfig cyrus-imapd on` |
| 71 |
|
| 72 |
You should now be able to login as the ``cyrus`` user, which is |
| 73 |
configured by default as an administrator for Cyrus IMAP: |
| 74 |
|
| 75 |
.. parsed-literal:: |
| 76 |
|
| 77 |
# :command:`imtest -t "" -u cyrus -a cyrus localhost` |
| 78 |
S: * OK [CAPABILITY IMAP4 IMAP4rev1 LITERAL+ ID STARTTLS LOGINDISABLED COMPRESS=DEFLATE] d5ec35c1414a Cyrus IMAP v2.3.16-Fedora-RPM-2.3.16-13.el6_6 server ready |
| 79 |
C: S01 STARTTLS |
| 80 |
S: S01 OK Begin TLS negotiation now |
| 81 |
verify error:num=18:self signed certificate |
| 82 |
TLS connection established: TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits) |
| 83 |
C: C01 CAPABILITY |
| 84 |
S: * CAPABILITY IMAP4 IMAP4rev1 LITERAL+ ID AUTH=PLAIN SASL-IR COMPRESS=DEFLATE ACL RIGHTS=kxte QUOTA MAILBOX-REFERRALS NAMESPACE UIDPLUS NO_ATOMIC_RENAME UNSELECT CHILDREN MULTIAPPEND BINARY SORT SORT=MODSEQ THREAD=ORDEREDSUBJECT THREAD=REFERENCES ANNOTATEMORE CATENATE CONDSTORE SCAN IDLE LISTEXT LIST-SUBSCRIBED X-NETSCAPE URLAUTH |
| 85 |
S: C01 OK Completed |
| 86 |
Please enter your password: |
| 87 |
C: A01 AUTHENTICATE PLAIN \*\*\*\*\*\*\*\*\*\*\*\* |
| 88 |
S: A01 OK [CAPABILITY IMAP4 IMAP4rev1 LITERAL+ ID LOGINDISABLED COMPRESS=DEFLATE ACL RIGHTS=kxte QUOTA MAILBOX-REFERRALS NAMESPACE UIDPLUS NO_ATOMIC_RENAME UNSELECT CHILDREN MULTIAPPEND BINARY SORT SORT=MODSEQ THREAD=ORDEREDSUBJECT THREAD=REFERENCES ANNOTATEMORE CATENATE CONDSTORE SCAN IDLE LISTEXT LIST-SUBSCRIBED X-NETSCAPE URLAUTH] Success (tls protection) |
| 89 |
Authenticated. |
| 90 |
Security strength factor: 256 |
| 91 |
. LIST "" "*" |
| 92 |
. OK Completed (0.000 secs 1 calls) |
| 93 |
C: Q01 LOGOUT |
| 94 |
* BYE LOGOUT received |
| 95 |
Q01 OK Completed |
| 96 |
Connection closed. |
| 97 |
|
| 98 |
Next, continue with :ref:`imap-configuring-the-mta`. |
| 99 |
|
| 100 |
.. _Red Hat, Inc.: https://redhat.com |