| 1 |
Fedora |
| 2 |
====== |
| 3 |
|
| 4 |
Fedora is a Linux distribution that does not generally enforce a policy |
| 5 |
of not providing you with upgrades of software during the life-cycle of |
| 6 |
any of the distribution's released versions, or what could otherwise be |
| 7 |
expected to constitute "stable". |
| 8 |
|
| 9 |
While package maintainers tend to want to prevent unpleasant surprises |
| 10 |
from being deployed to your Fedora system, and therefore generally |
| 11 |
ship only versions of one series to any one given released distribution |
| 12 |
version, the Cyrus project cannot guarantee you will not receive an |
| 13 |
upgrade at some point, and cannot guarantee this upgrade will run |
| 14 |
smoothly -- even though we do our best. |
| 15 |
|
| 16 |
To install the version of Cyrus IMAP that comes with the operating |
| 17 |
system, issue the following command for Fedora 18 or below: |
| 18 |
|
| 19 |
.. parsed-literal:: |
| 20 |
|
| 21 |
# :command:`yum install cyrus-imapd cyrus-sasl cyrus-sasl-plain` |
| 22 |
|
| 23 |
or for Fedora 19 and above: |
| 24 |
|
| 25 |
.. parsed-literal:: |
| 26 |
|
| 27 |
# :command:`dnf install cyrus-imapd cyrus-sasl cyrus-sasl-plain` |
| 28 |
|
| 29 |
Next, set a password for the default administrative user ``cyrus``: |
| 30 |
|
| 31 |
.. parsed-literal:: |
| 32 |
|
| 33 |
# :command:`passwd cyrus` |
| 34 |
Changing password for user cyrus. |
| 35 |
New password: |
| 36 |
Retype new password: |
| 37 |
passwd: all authentication tokens updated successfully. |
| 38 |
|
| 39 |
Start and configure to start when the system boots, the |
| 40 |
:manpage:`saslauthd` service. For Fedora 14 and below: |
| 41 |
|
| 42 |
.. parsed-literal:: |
| 43 |
|
| 44 |
# :command:`service saslauthd start` |
| 45 |
Starting saslauthd: [ OK ] |
| 46 |
# :command:`chkconfig saslauthd on` |
| 47 |
|
| 48 |
or for Fedora 15 and above: |
| 49 |
|
| 50 |
.. parsed-literal:: |
| 51 |
|
| 52 |
# :command:`systemctl start saslauthd` |
| 53 |
# :command:`systemctl enable saslauthd` |
| 54 |
|
| 55 |
You should at this moment be able to authenticate against |
| 56 |
:manpage:`saslauthd`: |
| 57 |
|
| 58 |
.. parsed-literal:: |
| 59 |
|
| 60 |
# :command:`testsaslauthd -u cyrus -p YOUR-PASSWORD` |
| 61 |
|
| 62 |
|
| 63 |
You should get an ``0: OK "Success."`` message. |
| 64 |
|
| 65 |
.. todo:: If this does not succeed, see ref `sasl-troubleshooting-saslauthd`. |
| 66 |
|
| 67 |
Start the service, and ensure the service starts up when the system |
| 68 |
boots. For Fedora 14 and below: |
| 69 |
|
| 70 |
.. parsed-literal:: |
| 71 |
|
| 72 |
# :command:`service cyrus-imapd start` |
| 73 |
# :command:`chkconfig cyrus-imapd on` |
| 74 |
|
| 75 |
or for Fedora 15 and above: |
| 76 |
|
| 77 |
.. parsed-literal:: |
| 78 |
|
| 79 |
# :command:`systemctl start cyrus-imapd` |
| 80 |
# :command:`systemctl enable cyrus-imapd` |
| 81 |
|
| 82 |
You should now be able to login as the ``cyrus`` user, which is |
| 83 |
configured by default as an administrator for Cyrus IMAP: |
| 84 |
|
| 85 |
.. parsed-literal:: |
| 86 |
|
| 87 |
# :command:`imtest -t "" -u cyrus -a cyrus localhost` |
| 88 |
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 |
| 89 |
C: S01 STARTTLS |
| 90 |
S: S01 OK Begin TLS negotiation now |
| 91 |
verify error:num=18:self signed certificate |
| 92 |
TLS connection established: TLSv1.2 with cipher DHE-RSA-AES256-GCM-SHA384 (256/256 bits) |
| 93 |
C: C01 CAPABILITY |
| 94 |
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 |
| 95 |
S: C01 OK Completed |
| 96 |
Please enter your password: |
| 97 |
C: A01 AUTHENTICATE PLAIN \*\*\*\*\*\*\*\*\*\*\*\* |
| 98 |
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) |
| 99 |
Authenticated. |
| 100 |
Security strength factor: 256 |
| 101 |
. LIST "" "*" |
| 102 |
. OK Completed (0.000 secs 1 calls) |
| 103 |
C: Q01 LOGOUT |
| 104 |
* BYE LOGOUT received |
| 105 |
Q01 OK Completed |
| 106 |
Connection closed. |
| 107 |
|
| 108 |
Next, continue with :ref:`imap-configuring-the-mta`. |