Difference between revisions of "Cyrus-imap"

From SME Server
Jump to navigationJump to search
m (added Howto & Mail categories)
 
(34 intermediate revisions by one other user not shown)
Line 1: Line 1:
−
'''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.
  
−
Cyrus-Imap
+
It adds cyrus-imap and a server-manager panel to SME-Server
  
−
How to install and use cyrus-imap on sme7
+
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
  
−
Summary:
+
==Beware !==
  
−
  1. Credits
+
===Replacing mail server===
−
  2. Installation
+
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"'''.
−
  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
+
If you are new to SME7 and linux, it might be advisable to try this on a test machine.
−
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.
+
===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.
  
−
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):
+
== Credits ==
  
−
    * smeserver-cyrus.tgz (no rpms)
+
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.
−
    * Note: these packages don't have rpms. Only install/uninstall scripts.
 
  
−
INSTALLATION
+
* smeserver-cyrus.tgz (no rpms)
 +
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/smeserver-cyrus.tgz
  
−
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.
+
* installation script
 +
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/install-cyrus.sh
  
−
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.
+
* uninstallation script
 +
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/uninstall-cyrus.sh
  
−
Beware!
+
* websieve
 +
http://www.logiciel-libre.org/downloads/cyrus-imap-sme-howto/websieve-cgi-bin.tgz
  
−
    The script uses password "%imapmail%" that needs to be set to something else!
+
=Installation=
  
−
Files:
+
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.
  
−
    * ./create-accounts
+
The script will install these packages:
−
    * /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:
+
* 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
  
−
#!/bin/sh
+
Note that POP and IMAP are rendered inaccessible from the Internet with these changes because the services are disabled in the configuration.
−
 
−
#
 
−
# =========================================================================
 
−
# 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</nowiki>
 
−
 
−
----
 
−
'''Uninstallation'''
 
−
<nowiki>
 
−
Uninstall with the script 'uninstall/uninstall'
 
−
The script must be a sub-folder named "uninstall"
 
  
−
#!/bin/sh
+
==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
  
−
# Uninstall script
+
==Updates==
−
#Uninstall RPMs
+
When updating (yum update) there is a problem from time to time with php-common.
−
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
+
The workaround is to remove php-common and reinstall it after the update:
−
rm /etc/rc.d/rc7.d/S71cyrus-imapd
+
rpm -e php-common
−
rm /etc/rc.d/rc0.d/K71cyrus-imap
+
yum -y update
−
rm /etc/rc.d/rc7.d/S71saslauthd
+
yum -y install php-common
−
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
+
=Administration=
−
rm -f /etc/e-smith/templates-custom/etc/cyrus.conf/*
+
The server-manager now has a new menu item at the bottom.
−
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
+
[[Image:Cyrus-imap-sme-account.jpg]]
−
/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</nowiki>
 
−
 
 
−
----
 
−
This script will reset to %imapmail%, all occurences of password:
 
−
 
 
−
<nowiki>#!/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</nowiki>
 
−
 
 
−
----
 
−
 
 
−
== Administration ==
 
−
The server-manager now has a new menu item at the bottom.
 
  
 
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.
Line 353: Line 109:
  
 
== Managing Accounts ==
 
== Managing Accounts ==
−
Mail 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
  
Line 375: Line 133:
  
 
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
 
  
 +
==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.
  
Line 390: Line 154:
  
 
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.
Line 416: Line 182:
 
     ./ipurge -f -d 0
 
     ./ipurge -f -d 0
  
−
Login:
+
Login with the password provided when installing:
  
 
     cyradm --user cyrus localhost
 
     cyradm --user cyrus localhost
Line 428: Line 194:
  
 
     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]]

Latest revision as of 08:01, 11 October 2009

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.

The cyrus-imap web site and other links:

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.

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.

Also note that the normal users's folders are not deleted and their content are intact.

It is then advisable to apply this howto on a new list of account that did not receive mail yet.

It is possible to keep messages by transfering them to a different server with the imapcopy tool. Then, after this installation, reimport them with the same tool.


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>.

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.

Access Rights - Explanation 

   * l: List
   * r: Read
   * s: Set Read Flag
   * w: Write
   * i: Insert
   * p: Post
   * c: Create
   * d: Delete
   * a: Administrator

To assign permissions to everybody, the group name is "anyone".

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.

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.

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.

File: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 cost is affordable at about 14USD per seat. This connector is for use where a group needs/wants/prefers/sticks to Outlook for whatever the reason. It provides for sharing calendars, address books, notes, todos, etc.

Beware of the Connector's concept of attachment to the server. Read the manual about this, it's important. Changing or reinstalling on the server will reset the internal ID of the server and all attached clients will see the server as a new one. Then all items on clients will be downloaded again!

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

Critical data are stored in /var/spool/imap

CLI can be used to manage some options. See the man pages here.

Folders that matter are: 

   * Cyrus config: /var/lib/imap
   * Cyrus mailboxes: /var/spool/imap

Backing up: 

   /etc/init.d/cyrus-imapd stop
   cp /var/lib/imap /somewhere
   cp /var/spool/imap /somewhere
   /etc/init.d/cyrus-imapd start

Administration: 

   cd /usr/lib/cyrus-imapd
   su cyrus
   ./mbexamine <box>
   ./mupdate
   ./reconstruct -r <box>
   ./chk_cyrus
   ./ipurge -f -d 0

Login with the password provided when installing: 

   cyradm --user cyrus localhost
   cyradm --user admin localhost

Purge mailboxes : 

   Force deletion of mail in all mailboxes: /usr/lib/cyrus-imapd/ipurge -f -d 0

Reconstruct: 

   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
Retrieved from "https://wiki.koozali.org/index.php?title=Cyrus-imap&oldid=13619"