624
edits
Changes
Jump to navigation
Jump to search
mLine 1:
Line 1: − + + + − Cyrus-Imap+ − How to install and use cyrus-imap on sme7+ + + + + − + + + + − Summary:+ − 1. Credits+ − 2. Installation+ − 3. Administration − 4. Mail accounts − 5. Quotas − 6. Shared folders − 7. Toltec's Outlook Connector − 8. CLI actions − Last modification 2008-03-17, 2008-05-17+ − 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 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. − 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.+ + − 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.+ + − Beware!+ + − The script uses password "%imapmail%" that needs to be set to something else!+ − Files:+ − * ./create-accounts+ − * /etc/e-smith/templates-custom/etc/hosts.deny/00startup − * /etc/e-smith/templates-custom/etc/cyrus.conf/cyrus − * /etc/e-smith/templates-custom/etc/cyrus.conf/template-begin − * /etc/e-smith/templates-custom/etc/cyrus.conf/template-end − * /etc/e-smith/templates-custom/etc/imapd.conf/imapd − * /etc/e-smith/templates-custom/etc/imapd.conf/template-begin − * /etc/e-smith/templates-custom/etc/imapd.conf/template-end − * /usr/lib/perl5/site_perl/5.8.5/Net/Telnet.pm − * /etc/e-smith/events/actions/user-create-cyrus − * /etc/e-smith/events/actions/user-delete-cyrus − * /etc/e-smith/templates-user-custom/.qmail/90local − * /etc/e-smith/templates-custom/etc/services/30cyrus-imap − * /etc/e-smith/web/functions/sherwood/sherwood70 − Script for installation:+ + + + + + + + + + + + + − #!/bin/sh+ − #+ − # =========================================================================+ − # Prepare files to use a different password+ − cyrus_password=<password_required>+ − # =========================================================================+ + + + + + + + + + + − mv -f sherwood70 sherwood70.old+ − mv -f user-create-unix user-create-unix.old+ − mv -f user-delete-unix user-delete-unix.old − mv -f user-create-cyrus user-create-cyrus.old − mv -f user-delete-cyrus user-delete-cyrus.old − mv -f create-accounts create-accounts.old − sed "s/%imapmail%/$cyrus_password/" create-accounts.old > create-accounts+ − sed "s/%imapmail%/$cyrus_password/" sherwood70.old > sherwood70+ − sed "s/%imapmail%/$cyrus_password/" user-create-unix.old > user-create-unix+ − sed "s/%imapmail%/$cyrus_password/" user-create-cyrus.old > user-create-cyrus+ − sed "s/%imapmail%/$cyrus_password/" user-delete-cyrus.old > user-delete-cyrus − sed "s/%imapmail%/$cyrus_password/" sherwood70.old > sherwood70 − + − # PHASE # 1+ − # ========================================================================= − − # Save current files − cp /etc/e-smith/events/actions/user-create-unix uninstall/user-create-unix-b4cyrus − cp /etc/e-smith/events/actions/user-delete-unix uninstall/user-delete-unix-b4cyrus − − #Stopping existing services (if running): − − /etc/rc.d/init.d/saslauthd stop − /etc/rc.d/init.d/xinetd stop − service imap stop − service imaps stop − − #Disabling existing IMAP & POP services: − − /sbin/e-smith/config setprop imap status disabled − /sbin/e-smith/config setprop imaps status disabled − /sbin/e-smith/config setprop pop3 status disabled − /sbin/e-smith/config setprop pop3s status disabled − − #Activating new services : − − /sbin/e-smith/config set saslauthd service InitscriptOrder 70 access private status enabled − /sbin/e-smith/config set cyrus-imapd service InitscriptOrder 71 access private status enabled − − # Initialisation des fichiers de configuration grace aux patrons − # Donne Acces au service cyrus imap qui ne demarre pas avec Xinetd − − #Installing custom-templates: − − mkdir -p /etc/e-smith/templates-custom/etc/hosts.deny/ − cp ./00startup /etc/e-smith/templates-custom/etc/hosts.deny/ − − − − # ========================================================================= − # PHASE # 2 − # ========================================================================= − − #Installation des RPMs − − yum -y install \ − 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 − − # ========================================================================= − # PHASE # 3 − # ========================================================================= − − # Configure Custom Templates − − #Configuration de Cyrus − − mkdir -p /etc/e-smith/templates-custom/etc/cyrus.conf/ − cp ./cyrus /etc/e-smith/templates-custom/etc/cyrus.conf/ − cp ./template-begin /etc/e-smith/templates-custom/etc/cyrus.conf/ − cp ./template-end /etc/e-smith/templates-custom/etc/cyrus.conf/ − mkdir -p /etc/e-smith/templates-custom/etc/imapd.conf/+ − cp ./imapd /etc/e-smith/templates-custom/etc/imapd.conf/ − cp ./template-begin /etc/e-smith/templates-custom/etc/imapd.conf/ − cp ./template-end /etc/e-smith/templates-custom/etc/imapd.conf/ − − # On ajoute un script Perl pour gerer les connexions Telnet − # dont nous avons besoin pour ajouter/supprimer des comptes IMAP − − mkdir /usr/lib/perl5/site_perl/5.8.5/Net − cp ./Telnet.pm /usr/lib/perl5/site_perl/5.8.5/Net/ − cp ./user-create-cyrus /etc/e-smith/events/actions/ − cp ./user-delete-cyrus /etc/e-smith/events/actions/ − − chmod 554 /etc/e-smith/events/actions/user-create-cyrus − chmod 554 /etc/e-smith/events/actions/user-delete-cyrus − − ln -s /etc/e-smith/events/actions/user-create-cyrus /etc/e-smith/events/user-create/S95user-create-cyrus − ln -s /etc/e-smith/events/actions/user-delete-cyrus /etc/e-smith/events/user-delete/S05user-delete-cyrus − − # Create symlinks for starting & stopping services − − #Configuring start up services − − ln -s /etc/rc.d/init.d/e-smith-service /etc/rc.d/rc7.d/S71cyrus-imapd − ln -s /etc/rc.d/init.d/cyrus-imapd /etc/rc.d/rc0.d/K71cyrus-imap − ln -s /etc/rc.d/init.d/saslauthd /etc/rc.d/rc7.d/S71saslauthd − ln -s /etc/rc.d/init.d/saslauthd /etc/rc.d/rc0.d/K71saslauthd − − # Configuring Qmail − # The original script changes permissions like this: − # chmod 4755 /var/qmail/bin/preline − # chmod 4755 /var/qmail/bin/sendmail − # ... but the standard permissions are already set to 0755 for files that exist. − # ... so why change? − chmod o+x /usr/lib/cyrus-imapd/deliver − # this sticky bit is used to allow a called process − # to inherit/assume the user credentials of the calling process. − − mkdir /etc/e-smith/templates-user-custom/.qmail/ − cp ./90local /etc/e-smith/templates-user-custom/.qmail/ − − mkdir -p /etc/e-smith/templates-custom/etc/services − cp ./30cyrus-imap /etc/e-smith/templates-custom/etc/services/ − − # On remet a jour les fichiers de configuration a partir des templates. − − #Expanding Templates − − /sbin/e-smith/expand-template /etc/hosts.deny − /sbin/e-smith/expand-template /etc/xinetd.conf − /sbin/e-smith/expand-template /etc/cyrus.conf − /sbin/e-smith/expand-template /etc/imapd.conf − /sbin/e-smith/expand-template /etc/services − − #Restarting services − − /etc/rc.d/init.d/xinetd start − /etc/rc.d/init.d/saslauthd start − /etc/rc.d/init.d/cyrus-imapd start − − #Configuring Server Manager − − cp ./sherwood70 /etc/e-smith/web/functions/sherwood − chown root:admin /etc/e-smith/web/functions/sherwood − chmod 4750 /etc/e-smith/web/functions/sherwood − − ln -s /etc/e-smith/web/functions/sherwood /etc/e-smith/web/panels/manager/cgi-bin/sherwood − − #Setting IMAP administration password − # The cyrus user was created by rpm (?) − # Change password for cyrus using the variable set at the beginning − echo $cyrus_password | `passwd cyrus --stdin >/dev/null 2>&1` − − # create cyrus-imap individual account based on user names − − chmod 750 create-accounts − ./create-accounts − /sbin/e-smith/db /home/e-smith/db/navigation/navigation.en set sherwood panel Description "cyrus-IMAP" DescriptionWeight 6750 Heading Configuration HeadingWeight 6000 − #/sbin/e-smith/db /home/e-smith/db/navigation/navigation.fr set sherwood panel Description "Gestion Des comptes Imap" DescriptionWeight 8555 Heading Sherwood HeadingWeight 8000 − #/sbin/e-smith/db /home/e-smith/db/navigation/navigation.fr-ca set sherwood panel Description "Gestion Des comptes Imap" DescriptionWeight 8555 Heading Sherwood HeadingWeight 8000 − − # Apply changes − − signal-event email-update − − − ---- − Uninstall with the script 'uninstall/uninstall' − The script must be a sub-folder named "uninstall" − − #!/bin/sh − − # Uninstall script − #Uninstall RPMs − rpm -e cyrus-imapd-murder − rpm -e cyrus-imapd-devel − rpm -e cyrus-imapd-nntp − rpm -e cyrus-imapd-utils − rpm -e cyrus-imapd − rpm -e perl-Cyrus − rpm -e cyrus-sasl-plain − rpm -e cyrus-sasl-devel − rpm -e cyrus-sasl-gssapi − rpm -e cyrus-sasl-ntlm − rpm -e cyrus-sasl-sql − − #Remove files − rm /etc/rc.d/rc7.d/S71cyrus-imapd − rm /etc/rc.d/rc0.d/K71cyrus-imap − rm /etc/rc.d/rc7.d/S71saslauthd − rm /etc/rc.d/rc0.d/K71saslauthd − rm /usr/lib/perl5/site_perl/5.8.5/Net/Telnet.pm − rmdir /usr/lib/perl5/site_perl/5.8.5/Net − rm -f /etc/e-smith/events/user-create/S95user-create-cyrus − rm -f /etc/e-smith/events/user-delete/S05user-delete-cyrus − rm -f /etc/e-smith/events/actions/user-create-cyrus − rm -f /etc/e-smith/events/actions/user-delete-cyrus − − # Reconfigure Custom Templates − rm -f /etc/e-smith/templates-custom/etc/cyrus.conf/* − rmdir /etc/e-smith/templates-custom/etc/cyrus.conf/ − − rm -f /etc/e-smith/templates-custom/etc/imapd.conf/* − rmdir /etc/e-smith/templates-custom/etc/imapd.conf/ − − # Rebuild Templates − rm -f /etc/e-smith/templates-custom/etc/hosts.deny/00startup − rm -f /etc/e-smith/templates-user-custom/.qmail/* − rmdir /etc/e-smith/templates-user-custom/.qmail − rm -f /etc/e-smith/templates-custom/etc/services/30cyrus-imap − − # Expand Templates − /sbin/e-smith/expand-template /etc/hosts.deny − /sbin/e-smith/expand-template /etc/xinetd.conf − /sbin/e-smith/expand-template /etc/services − − # Remove Server-Manger Panel − rm /etc/e-smith/web/functions/sherwood − rm /etc/e-smith/web/panels/manager/cgi-bin/sherwood − − /sbin/e-smith/db /home/e-smith/db/navigation/navigation.en delete sherwood − /sbin/e-smith/db /home/e-smith/db/navigation/navigation.fr delete sherwood − /sbin/e-smith/db /home/e-smith/db/navigation/navigation.fr-ca delete sherwood − − # Reinstall Original Service settings − /sbin/e-smith/config delete saslauthd − /sbin/e-smith/config delete cyrus-imapd − /sbin/e-smith/config setprop imap status enabled − /sbin/e-smith/config setprop imaps status enabled − /sbin/e-smith/config setprop pop3 status enabled − /sbin/e-smith/config setprop pop3s status enabled − /etc/rc.d/init.d/saslauthd stop >/dev/null 2>&1 − /etc/rc.d/init.d/xinetd restart >/dev/null 2>&1 − − # Note: the script does not remove user "cyrus" − # if it was not delete when removing RPMs then delete it: − # userdel -r cyrus − − service imap start − signal-event email-update − − ---- − This script will reset to %imapmail%, all occurences of password: − − #!/bin/sh − − cyrus_password=<password_to_be_reset> − − rm -f *.old − − mv -f sherwood70 sherwood70.old − mv -f user-create-unix user-create-unix.old − mv -f user-delete-unix user-delete-unix.old − mv -f user-create-cyrus user-create-cyrus.old − mv -f user-delete-cyrus user-delete-cyrus.old − mv -f create-accounts create-accounts.old − − sed "s/$cyrus_password/%imapmail%/" create-accounts.old > create-accounts − sed "s/$cyrus_password/%imapmail%/" sherwood70.old > sherwood70 − sed "s/$cyrus_password/%imapmail%/" user-create-unix.old > user-create-unix − sed "s/$cyrus_password/%imapmail%/" user-create-cyrus.old > user-create-cyrus − sed "s/$cyrus_password/%imapmail%/" user-delete-cyrus.old > user-delete-cyrus − sed "s/$cyrus_password/%imapmail%/" sherwood70.old > sherwood70 − − ---- − − == Administration == − The server-manager now has a new menu item at the bottom. Line 355:
Line 109: − Mail Accounts − + + − + + + Line 377:
Line 133: − + + − + + − Toltec's Outlook Connector + + + + + Line 392:
Line 154: − + + + Line 418:
Line 182: − + Line 430:
Line 194: + + + + + + + + + + +
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.
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 ==
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=
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
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.
[[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.
It is advisable to plan ahead if users are already defined and have content in their mail boxes. With installation, new imap accounts will be created, but old content will not be transfered to new folder structure. The tool imapcopy is handy to move users's content to a temporary imap server, and restored the same way after installation.
It is advisable to plan ahead if users are already defined and have content in their mail boxes. With installation, new imap accounts will be created, but old content will not be transfered to new folder structure. The tool imapcopy is handy to move users's content to a temporary imap server, and restored the same way after installation.
Access Rights - Explanation
Access Rights - Explanation
To assign permissions to everybody, the group name is "anyone".
To assign permissions to everybody, the group name is "anyone".
Quotas
==Quotas==
Quotas for each account is set to 100MB by default. This means that this space will be "reserved" on the server. So increasing default quota to 1GB for 20 users would reserve 20GB on the server.
Quotas for each account is set to 100MB by default. This means that this space will be "reserved" on the server. So increasing default quota to 1GB for 20 users would reserve 20GB on the server.
Shared folders
==Shared folders==
With this installation (without Toltec Connector), sharing folders is done from the server-manager. Creating a folder and assigning access rights allows for other users and groups to see the account. EGroupware, Thunderbird, Outlook work with this. But note that Outlook will interfere with other clients with its character coding for languages like french.
With this installation (without Toltec Connector), sharing folders is done from the server-manager. Creating a folder and assigning access rights allows for other users and groups to see the account. EGroupware, Thunderbird, Outlook work with this. But note that Outlook will interfere with other clients with its character coding for languages like french.
==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.
Toltec Connector wants to see the server as a POP account and each station can provide for content to be shared. Permissions need to be set for each station providing content to someone or to others.
Toltec Connector wants to see the server as a POP account and each station can provide for content to be shared. Permissions need to be set for each station providing content to someone or to others.
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
=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]]