EDIT - AMENDED FOR 6.30.9-1 - 25/1/10, UPDATED TO 6.30.12-1 - 15/4/10, UPDATED TO 6.40.0 21/6/10, Fixed locale menu's, UPDATE app-zarafa-5.1-4, UPDATE app-zarafa-5.1.5 (Italian locale, thanks Paolo!), UPDATE app-zarafa-5.1.6, UPDATE app-zarafa-5.1.7. UPDATE Zarafa-6.40.6

THIS THREAD IS NOW OLD, ZARAFA 7.x IS NOW AVAILABLE HERE

FOR UPGRADES FROM 6.30.x to 6.40.x SEE HERE

I have rebuilt Zarafa so that it runs on ClearOS using the updated version of ldap. The RPM's are now rebuilt using the maintained SRPM's from Fedora (courtesy of Robert Scheck).

The following will install and configure the webmail so that it authenticates against ClearOS users defined in the webconfig. It will configure Postfix so that all mail is delivered to the Zarafa inbox. The contacts list and calendars will function

Please note that Zarafa is intended as a full gateway solution, and therefore only part of the serrvices are actually required. You could feasibly configure it to run all your POP / IMAP access etc. Only the brief configuration is shown below to get it working. The rest can be found in the man pages for the various elements or on the zarafa site.

[img size=200]http://starlane.gotdns.org/files/zarafa-webaccess.jpg[/img][img size=200]http://starlane.gotdns.org/files/app-zarafa.png[/img]

INSTALL
Install the community repo as per instructions HERE

yum --enablerepo=timb install app-zarafa zarafa zarafa-webaccess

And the following work around to fix the webaccess attachment upload

cd /usr/share/zarafa-webaccess/client/widgets/

wget ftp://www.timburgess.net/zarafa/swfupload-zarafa.tar.gz

tar zxvf swfupload-zarafa.tar.gz

UPGRADES

yum --enablerepo=timb upgrade app-zarafa zarafa zarafa-webacess

Alternatively you can find the RPM's here
http://download.clearfoundation.com/community/timb80/repo/clearos/5.2/os/

CONFIGURATION
Go to the Webconfig > System > Mail > Zarafa and finish the configuration.

If you are installing the first time, make sure you select your database type. You can use either the System-Mysql database (which is used by Horde and the webconfig) or the normal "user" Mysql instance. The former is preferred as it means you do not need to setup Mysql if you don't need it, and your data is less likely to be inadvertently removed.

For "user" mysql you will also need to enter your MYSQL root password, so that Zarafa can create the database for mail storage.

Now you will also need to add users or your domain to the Email delivery configuration. Here you can specify specific users mail to be delivered via the Zarafa mail system, in the format 'user@domain.com'. This way other users email will still be accessible via Horde etc. Or you can specify the whole domain to be delivered to Zarafa by adding 'domain.com'.

NOTE: If you use Fetchmail for mail retrieval it will be directed to user@localhost.domain.com. Therefore to have this passed to Zarafa also add localhost.domain.com

Now start the 3 CORE services, Zarafa-Dagent, Zarafa-Spooler and Zarafa-Server.

Navigate to https://yourwebserver.com:84/webaccess and login
If you have the web server running, you can also use https://yourwebserver.com/webacess

Z-Push ActiveSync
If you want to Sync your mailbox with your mobile follow the Howto HERE

OPTIONAL Outlook MAPI Connectivity
NOT required for normal IMAP/POP3 or Webaccess

wget http://download.clearfoundation.com/community/timb80/zarafa/zarafa-licensed-6.40.8-27223.i386.rpm

rpm -Uvh --nodeps zarafa-licensed-6.40.8-27223.i386.rpm

service zarafa-licensed restart

service zarafa-server restart

Note that the community edition has a limit of 3 Win32 MAPI users. If you review /var/log/zarafa/licensed.log you should now see the presence of the licensed module. If you have a license - save it to /etc/zarafa/license/

Mon 18 Jan 2010 12:34:20 PM GMT: Starting zarafa-licensed version 6,40,5,24860 (20653), pid 16640

Mon 18 Jan 2010 12:34:20 PM GMT: Serial in '/etc/zarafa/license' is invalid. Assuming default 3-user license

Mon 18 Jan 2010 12:34:20 PM GMT: License is for 3 Win32 MAPI users

Install the zarafa-client MSI installer to your client PC. This will enable "Zarafa 6" as a new outlook mail server type. Follow steps to create a new user Mail profile from Control Panel selecting 'Other type of account' then select Zarafa 6. You can download the client here, or direct from Zarafa.com
http://download.clearfoundation.com/community/timb80/zarafa/win32/zarafaclient-6.40.5.msi

DOCUMENTATION
For more details read the user manual, which is very good. You can now use Outlook as it was connected to Exchange, share contacts, folders, calendars, public folders etc
www.zarafa.com/content/documentation

MIGRATION
You can find details for migrating outlook users here, and also using imapsync
http://download.zarafa.com/zarafa/release/docs/zarafa_migration.en.pdf

For example you can use the imapsync tool to copy files from one IMAP mailbox to another. Setup the zarafay-gateway service (in this case set IMAP to port 8143), and transfer from the existing ClearOS IMAP service on port 143. (Add the --dry option to trial options first). If you wish to delete the mail from the original IMAP add --expunge1 --delete)

imapsync \

--host1 192.168.1.1:143 --user1 yourusername --password1 yourpassword --prefix1 INBOX  --authmech1 LOGIN \

--host2 192.168.1.1:8143 --user2 yourusername --password2 yourpassword --prefix2 INBOX --authmech2 LOGIN \

  --subscribe --sep2=/ --useheader 'Message-ID' --skipsize

IMAPS / POP3S Gateway Config
Copy the system certificates to the right place:-

cp /etc/postfix/key.pem /etc/zarafa/gateway/privkey.pem

cp /etc/postfix/cert.pem /etc/zarafa/gateway/cert.pem

Then navigate to the System > certificate manager in the webconfig, click the Certificate Authority button, then click install. You should then be prompted about accepting the security certificate on your local machine. This will install the ClearOS cert so that it can certify it's own certificates, otherwise you will get a warning on the client every time you connect about "no certficate authority". Alterntively pay for a signed certficate from a recognised authority and upload it to your box.

Then enable IMAPS and POP3 in the Zarafa config, press Update.

Now configure your client to use relevant port (eg 993 for IMAPS) and select SSL as the encryption (auto didn't work well for me). It should connect as per the IMAP or POP settings.

KNOWN ISSUES:-
-Mail archive will only work if the ClearOS IMAP service is left running
-Zarafa-Gateway POP3/IMAP ports conflict with ClearOS POP3/IMAP so change the ports manually or disable the ClearOS mail services.

PROBLEM SOLVING:-
If you have problems check the respective log files in /var/log/zarafa/
If zarafa-server fails to run on boot, try editing the "run_as_user" in /etc/zarafa/server.cfg to root and let us know (Thanks to Keil Gyozo for spotting this one)

ENJOY! ...BIG thanks to all the forum users who have tested this and use it. This howto and now module would not have come this far without you. If you find the above useful, buy my a beer sometime, or just say hi and thanks in the forum