Zarafa
Maintainers
Darrell May
Stephen Noble http://dungog.net/wiki
Description
Zarafa is a workgroup sharing solution based on the look-and-feel of Microsoft Outlook, which enables the sharing of mail and appointments from Outlook and a web-based interface.
Installation
Download & install ...
Zarafa rpms
http://www.zarafa.com/download-community
Distribution = Rhel 4
3 Outlook license version (or possibly just disable licensed service for the GPL version, check please)
tar -zxvf zarafa-6.20-rhel4-i386.tar.gz yum localinstall libvmime*.rpm libical*.rpm zarafa-6*.rpm zarafa-webaccess-6*.rpm zarafa-licensed-6*.rpm
smeserver-zarafa
Install a fresh SME 7.4 test server and perform the following:
yum install smeserver-zarafa --enablerepo=smetest
After rpm install execute the following:
/etc/e-smith/events/actions/zarafa-install signal-event post-upgrade; signal-event reboot
Enable mail delivery to zarafa for users:
for all users
config setprop zarafa-server GlobalForward enabled
or for individual users
db accounts setprop $USERNAME zarafa enabled
apply
/etc/e-smith/events/actions/qmail-update-user
If you chose the db plugin, run:
/etc/e-smith/events/actions/zarafa-create-user
Usage
Webmail
Access with a browser,
https://server/zarafa https://server/webaccess https://server/webmail (with Horde disabled '/server-manager > Email > Webmail Access')
Outlook
To use MS Outlook install the zarafaclient-*.msi add-on contained in the win32 directory of zarafa-*.tar.gz
- Outlook 2007 client generates Error 0x80070057 on send and receive if the Zarafa
server is added to an existing profile. Creating a new clean profile solved the problem.
IMAP
The default ports for Zarafa are 8000 + default values
so imap = 8143, imaps 8993
SME and Zarafa use different folder naming.
drafts > Drafts [client specific ?, Drafts is default Thunderbird-2.0] sent-mail > Sent Items trash > Deleted Items junkmail > Junk E-mail
Thunderbird
The Thunderbird client uses its own Trash folder, not the Zarafa "Deleted Items" folder,
Change in the config editor
Preferences > advance > config editor, find mail.server.number and add new string as below
user_pref("mail.server.server5.port", "8143"); user_pref("mail.server.server5.name", "zac@232.net"); user_pref("mail.server.server5.numHdrsToKeep", 30); user_pref("mail.server.server5.timeout", 29); right click > new preference name > mail.server.server5.trash_folder_name value > Deleted Items +user_pref("mail.server.server5.trash_folder_name", "Deleted Items");
Drafts and Sent Items can be changed in : Account Settings > user > Copies and Folders
If junkmail exists just delete it.
Calendar
To access the calendar functions with an iCal client eg, Thunderbird and Lighting
in Thunderbird/Lightning > New Calendar > on network > ical > http://<domain>:8088/ical/<user>/calendar/
8089 for SSL
Note, there were problems with reading events created with /webaccess, seems better with RC1
It's a know problem. Zarafa 6.30 will use CalDEV instead of iCal
Mobile synchronisation
To enable synchronization of your mobile phone through ActiveSync with Zarafa, Z-push needs to be installed.
You can find the original Z-push installation documentation here: http://download.zarafa.com/zarafa/release/docs/z-push_installation_manual.en.pdf
Download the latest Z-push version (see: http://z-push.sourceforge.net).
wget http://download2.berlios.de/z-push/z-push-1.2.1.tar.gz
Extract the files:
tar -zxvf z-push-1.2.1.tar.gz -C /var/www/html
'State'-dir needs to be writable for apache:
chmod 755 /var/www/html/z-push/state chown www:www /var/www/html/z-push/state
Expand and restart
expand-template /etc/httpd/conf/httpd.conf sv restart httpd-e-smith
SSL Synchronization with Windows Mobile devices
Synchronisation over a secured connection is possible if you can add your site as a trusted one with corresponding certificate on your mobile.
This is the case for Windows mobile 6 (WM6) devices. Problems should occurs on several WM5 devices, because of a bug that limits addition of certificates with that OS.
Here are the steps to add your server as a trusted platform on your WM6 mobile :
1. to convert your server's certificate into a (Binary coded DER X.509) .cer file you can either run the following command and skip to step 4 or just start at the next step.
openssl x509 -in /home/e-smith/ssl.pem/<certificate name>.pem -inform PEM -out /root/<certificate name>.cer -outform DER
2. copy your server's certificates located in /home/e-smith/ssl.crt/ on a Windows XP/Vista computer
3. we need to transform those .crt certificates to .cer certificate ( same type of certificate but .crt are text-encoded ). To do so :
- in microsoft windows open a certificate by double clicking on it
- in "Detail" Tab pane choose "Copy to file"
- Choose Binary coded DER X.509 (.cer) format
- save resulting .cer certificates on local machine
4. transfer .cer certificates on your mobile using windows explorer
5. When done, on your WM6 mobile use file explorer to open those certificates. When opening one, the certificate is automatically added to trusted sites.
6. You can then change your Exchange server parameters to use SSL. It will be asked to reenter your password.
Know working hardware
Tested and working with WinMobile 6.1 on a HTC TyTN II over a SSL connection / mail-push is working.
Tested and working with WinMobile 6.1 on an upgraded QTEK9100 over SSL connection. Push mail not tested.
Mail Sorting
Maildrop as configured with smeserver-mailsorting will deliver to ~/Maildir rather than zarafa
For now either disable sorting or bypass for zarafa users.
Procmail will sort to zarafa from smeserver-mailsorting-1.2-29
Extras
Command line admin
man zarafa for details
List users:
/usr/bin/zarafa-admin -l
Update a user to admin status:
/usr/bin/zarafa-admin -u <username> -a 1
Migrating users and data to Zarafa
http://wiki.contribs.org/Imapsync
Customizing the Calendar
The labels and categories in the calendar can be altered to suit user requirements.
The labels are defined in /var/www/html/webaccess/client/layout/dialogs/standard/appointment.php beginning at line 225
The categories are in /var/www/html/webaccess/client/layout/dialogs/modal/categories.php beginning at line 51.
Zarafa Bayesian learning
This howto enables SpamAssasin Bayesian learning for Zarafa
Bugs
Check your logs when troubleshooting or reporting bugs
tail -f /var/log/zarafa/* tail /var/log/slapd tail /var/log/messages
Please raise bugs under the SME-Contribs section in bugzilla and select the smeserver-zarafa component or use this link .
Search open bugs for smeserver-zarafa at bugs.contribs.org
Zarafa: use their forum for zarafa specific bug reporting, http://forums.zarafa.com/