| 1 |
.. _imap-installation-distributions-centos: |
| 2 |
|
| 3 |
CentOS |
| 4 |
====== |
| 5 |
|
| 6 |
Currently supported versions of CentOS include Cyrus IMAP packages in |
| 7 |
the repositories configured on a stock system: |
| 8 |
|
| 9 |
* Cyrus IMAP |imap_tikanga_stock_version| for CentOS 5 |
| 10 |
* Cyrus IMAP |imap_santiago_stock_version| for CentOS 6 |
| 11 |
* Cyrus IMAP |imap_maipo_stock_version| for CentOS 7 |
| 12 |
|
| 13 |
.. NOTE:: |
| 14 |
|
| 15 |
The Cyrus project does not support running any versions of the Cyrus |
| 16 |
IMAP software older than the version of the software shipped |
| 17 |
with the operating system itself. |
| 18 |
|
| 19 |
To install the version of Cyrus IMAP that comes with the operating |
| 20 |
system, issue the following command: |
| 21 |
|
| 22 |
.. parsed-literal:: |
| 23 |
|
| 24 |
# :command:`yum install cyrus-imapd cyrus-sasl cyrus-sasl-plain` |
| 25 |
|
| 26 |
Next, set a password for the default administrative user ``cyrus``: |
| 27 |
|
| 28 |
.. parsed-literal:: |
| 29 |
|
| 30 |
# :command:`passwd cyrus` |
| 31 |
Changing password for user cyrus. |
| 32 |
New password: |
| 33 |
Retype new password: |
| 34 |
passwd: all authentication tokens updated successfully. |
| 35 |
|
| 36 |
Start and configure to start when the system boots, the |
| 37 |
:manpage:`saslauthd` service: |
| 38 |
|
| 39 |
.. parsed-literal:: |
| 40 |
|
| 41 |
# :command:`service saslauthd start` |
| 42 |
Starting saslauthd: [ OK ] |
| 43 |
# :command:`chkconfig saslauthd on` |
| 44 |
|
| 45 |
You should at this moment be able to authenticate against |
| 46 |
:manpage:`saslauthd`: |
| 47 |
|
| 48 |
.. parsed-literal:: |
| 49 |
|
| 50 |
# :command:`testsaslauthd -u cyrus -p YOUR-PASSWORD` |
| 51 |
|
| 52 |
You should get an ``0: OK "Success."`` message. |
| 53 |
|
| 54 |
.. todo:: |
| 55 |
If this does not succeed, see ref:`sasl-troubleshooting-saslauthd`. |
| 56 |
|
| 57 |
Start the service, and ensure the service starts up when the system |
| 58 |
boots: |
| 59 |
|
| 60 |
.. parsed-literal:: |
| 61 |
|
| 62 |
# :command:`service cyrus-imapd start` |
| 63 |
# :command:`chkconfig cyrus-imapd on` |
| 64 |
|
| 65 |
You should now be able to login as the ``cyrus`` user, which is |
| 66 |
configured by default as an administrator for Cyrus IMAP: |
| 67 |
|
| 68 |
.. parsed-literal:: |
| 69 |
|
| 70 |
# :command:`imtest -t "" -u cyrus -a cyrus localhost` |
| 71 |
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 |
| 72 |
C: S01 STARTTLS |
| 73 |
S: S01 OK Begin TLS negotiation now |
| 74 |
verify error:num=18:self signed certificate |
| 75 |
TLS connection established: TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits) |
| 76 |
C: C01 CAPABILITY |
| 77 |
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 |
| 78 |
S: C01 OK Completed |
| 79 |
Please enter your password: |
| 80 |
C: A01 AUTHENTICATE PLAIN \*\*\*\*\*\*\*\*\*\*\*\* |
| 81 |
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) |
| 82 |
Authenticated. |
| 83 |
Security strength factor: 256 |
| 84 |
. LIST "" "*" |
| 85 |
. OK Completed (0.000 secs 1 calls) |
| 86 |
C: Q01 LOGOUT |
| 87 |
* BYE LOGOUT received |
| 88 |
Q01 OK Completed |
| 89 |
Connection closed. |
| 90 |
|
| 91 |
Next, continue with :ref:`imap-configuring-the-mta`. |