624
edits
Changes
Jump to navigation
Jump to search
mLine 1:
Line 1: − + − =Cyrus-Imap=+ + − How to install and use cyrus-imap on sme7+ − Beware !+ − You'll be modifying the SME7 and some actions will required from time to time when updates are reacting with this modification. If you are new to SME7 and linux, it might be advisable to try this on a test machine.+ + − Cyrus-imap enables folder sharing of mail items. Coupled with the Toltec connector, it can replace many functions of the Exchange Server with mail client Outlook.+ + − + + + + + + + + + + + + + − − The packages are available from here for Toltec and without Toltec. Look under "Tech. Forum" menu. Versions without RPMS (which are not needed anymore) are available here (about 68KB): Line 34:
Line 47: − ==Installation==+ − Note that POP and IMAP are rendered inaccessible from the Internet with these changes. It better to leave that so since vulnerabilities with this cyrus-imap implementation are not managed and investigated by the dev-team.+ + + + + + + + + + + + + + + + + + Line 47:
Line 77: + Line 54:
Line 85: − + + + + + + + + + + + Line 68:
Line 109: − [[Image:sme-account.jpg]] − Mail Accounts+ + − The standard SME folder structure for mail is in /home/e-smith/files/users/<user>/Maildir.+ − + − Line 103:
Line 143: + + + Line 113:
Line 156: + Line 151:
Line 195: − ==Uninstallation==+ − + + + + + +
added Howto & Mail categories
'''This page is in preparation. I'm not done yet!'''
'''Cyrus-Imap'''
This is a rather complicated modification of SME7 to maintain. But it works fine.
Recently, Zarafa became opensource and should be evaluated first.
It adds cyrus-imap and a server-manager panel to SME-Server
This howto works also for SME8.
=How to install and use cyrus-imap on sme7 and sme8=
Cyrus-imap enables folder sharing of mail items. Coupled with the Toltec connector, it can replace many functions of the Exchange Server with mail client Outlook.
By Sophie Romano (SopRom) http://www.logiciel-libre.org
I am not a developper and this HowTo is mainly for the records!
This howto presents installation and usage of the cyrus-imap server on a Sme-Server system.
This howto presents installation and usage of the cyrus-imap server on a Sme-Server system.
The cyrus-imap web site is at [http://cyrusimap.web.cmu.edu/]
The cyrus-imap web site and other links:
* http://cyrusimap.web.cmu.edu.
* http://www.delouw.ch/linux/Postfix-Cyrus-Web-cyradm-HOWTO/html/cyrus-config.html
* http://artisan.karma-lab.net/node/1149
==Beware !==
===Replacing mail server===
You'll be modifying the SME7 and some actions will be required from time to time, when updates are applied. For example, the file preline has its permissions resetted after some updates. '''Always test send/receive after a "yum update"'''.
If you are new to SME7 and linux, it might be advisable to try this on a test machine.
===Scripts===
I am not a programmer. I assembled these scripts from the works of others (Lionel and Jon) and adapted them to SME7. There is no translation since the implementation of the new language engine.
== Credits ==
== Credits ==
The original scripts were developped by Mr. Lionel Debrus for SME6. Then, Jon Roberts from WestCountryBusiness adapted them for SME7. Since, Jon has switched to a different solution and might not be available to provide updates.
The original scripts were developped by Mr. Lionel Debrus for SME6. Then, Jon Roberts from WestCountryBusiness adapted them for SME7. Since, Jon has switched to a different solution and might not be available to provide updates.
* smeserver-cyrus.tgz (no rpms)
* smeserver-cyrus.tgz (no rpms)
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/websieve-cgi-bin.tgz
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/websieve-cgi-bin.tgz
=Installation=
Some services (imap, imaps, pop, pops) are disabled and replaced. After the installation of needed RPMS, templates are created and expanded, and newly replaced services are enabled. Finally, a panel is added to the server-manager menu.
Some services (imap, imaps, pop, pops) are disabled and replaced. After the installation of needed RPMS, templates are created and expanded, and newly replaced services are enabled. Finally, a panel is added to the server-manager menu.
The script will install these packages:
* cyrus-imapd
* cyrus-imapd
* cyrus-imapd-devel
* cyrus-imapd-murder
* cyrus-imapd-nntp
* cyrus-imapd-utils
* cyrus-sasl-devel
* cyrus-sasl-gssapi
* cyrus-sasl-ntlm
* cyrus-sasl-plain
* perl-Cyrus
* cyrus-sasl
* cyrus-sasl-md5
Note that POP and IMAP are rendered inaccessible from the Internet with these changes because the services are disabled in the configuration.
==Install==
mkdir -p /root/cyrus/uninstall
mkdir -p /root/cyrus/uninstall
cd /root/cyrus
cd /root/cyrus
cd smeserver-cyrus
cd smeserver-cyrus
wget http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/install-cyrus.sh
wget http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/install-cyrus.sh
wget http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/restore_db.sh
chmod u+x install-cyrus.sh
chmod u+x install-cyrus.sh
cd uninstall
cd uninstall
./install-cyrus.sh
./install-cyrus.sh
== Administration ==
==Updates==
When updating (yum update) there is a problem from time to time with php-common.
The workaround is to remove php-common and reinstall it after the update:
rpm -e php-common
yum -y update
yum -y install php-common
=Administration=
The server-manager now has a new menu item at the bottom.
The server-manager now has a new menu item at the bottom.
[[Image:Cyrus-imap-sme-account.jpg]]
Imap accounts are based on the users list already existing on the server. They have been migrated to the new location.
Imap accounts are based on the users list already existing on the server. They have been migrated to the new location.
== Managing Accounts ==
== Managing Accounts ==
The standard SME folder structure for mail is in
/home/e-smith/files/users/<user>/Maildir.
With cyrus-imap, the new structure is in
/var/spool/imap/<user>/user/<user>.
With cyrus-imap, the new structure is in /var/spool/imap/<user>/user/<user>.
The standard structure is not destroyed with the installation and content just stay there, unreachable. If mail options in the server-manager are switched back to pop enabled and imap enabled, the standard structure is reactivated. When disabled, the cyrus-iamp structure is active.
The standard structure is not destroyed with the installation and content just stay there, unreachable. If mail options in the server-manager are switched back to pop enabled and imap enabled, the standard structure is reactivated. When disabled, the cyrus-iamp structure is active.
==Toltec's Outlook Connector==
==Toltec's Outlook Connector==
Although folder sharing works fine with EGroupware, Thunderbird, etc., it also provides the base for Exchange functionnalities. So with a connector (non-free) we can have Outlook clients share calendars, contacts, notes... Toltec makes one of these connectors. It's not expensive, it works.
[[Image:tolec.perm.jpg]]
[[Image:tolec.perm.jpg]]
The connector is available from here and the manual from here (toltec.co.za). It has been tested with the Kolab server.
The connector is available from here and the manual from here (toltec.co.za). It has been tested with the Kolab server.
==Cyradm==
==Cyradm==
'''Critical data are stored in /var/spool/imap'''
CLI can be used to manage some options. See the man pages here.
CLI can be used to manage some options. See the man pages here.
Reconstruct: /usr/lib/cyrus-imapd/reconstruct -r -f user.username
Reconstruct: /usr/lib/cyrus-imapd/reconstruct -r -f user.username
=Uninstallation=
To uninstall, run the script /root/cyrus/uninstall-cyrus.sh
To uninstall, run the script /root/cyrus/uninstall-cyrus.sh
cd /root/cyrus
cd /root/cyrus
chmod u+x uninstall-cyrus.sh
chmod u+x uninstall-cyrus.sh
signal-event post-upgrade && signal-event reboot
./uninstall-cyrus.sh
signal-event post-upgrade && signal-event; reboot
----
[[Category:Howto]]
[[Category:Mail]]