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.+ + − + + + + + + + + + + + + + Line 20:
Line 35: − 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):+ + + + + + + + − * smeserver-cyrus.tgz (no rpms)+ − * Note: these packages don't have rpms. Only install/uninstall scripts.+ − + − 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 45:
Line 109: − Mail Accounts − + + − + + Line 79:
Line 144: + + + Line 88:
Line 156: + Line 113:
Line 182: − + Line 126:
Line 195: − + + + + + + + + + +
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)
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/smeserver-cyrus.tgz
* installation script
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/install-cyrus.sh
* uninstallation script
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/uninstall-cyrus.sh
* websieve
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/websieve-cgi-bin.tgz
==INSTALLATION==
=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:
== Administration ==
* 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
cd /root/cyrus
wget http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/smeserver-cyrus.tgz
wget http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/websieve-cgi-bin.tgz
tar -xz --directory="." -f smeserver-cyrus.tgz
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/restore_db.sh
chmod u+x install-cyrus.sh
cd uninstall
wget http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/uninstall-cyrus.sh
chmod u+x uninstall-cyrus.sh
cd ..
./install-cyrus.sh
==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.
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]]
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.
./ipurge -f -d 0
./ipurge -f -d 0
Login:
Login with the password provided when installing:
cyradm --user cyrus localhost
cyradm --user cyrus localhost
Reconstruct: /usr/lib/cyrus-imapd/reconstruct -r -f user.username
Reconstruct: /usr/lib/cyrus-imapd/reconstruct -r -f user.username
[[Image:Example.jpg]]
=Uninstallation=
To uninstall, run the script /root/cyrus/uninstall-cyrus.sh
cd /root/cyrus
chmod u+x uninstall-cyrus.sh
./uninstall-cyrus.sh
signal-event post-upgrade && signal-event; reboot
----
[[Category:Howto]]
[[Category:Mail]]