ClearFoundation

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.



INSTALL
Install the community repo as per instructions HERE

And the following work around to fix the webaccess attachment upload


UPGRADES

Alternatively you can find the RPM's here
download.clearfoundation.com/community/t...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 yourwebserver.com:84/webaccess and login
If you have the web server running, you can also use 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


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/


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
download.clearfoundation.com/community/t...afaclient-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
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)


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

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

Tim,

Excellent howto. I really like Zarafa.

Only had one issue on this one. If you have already used your howto on upgrading to PHP 5.2.9, the php-mapi rpm won't work. Not a real problem if you can go back to the one included with ClearOS.

Again, Thanks.

Thanks ! I like Zarafa too, very slick interface

Good point, and one I should have highlighted - the RPM is compiled against PHP5.1.6 the standard PHP version in ClearOS. I may compile another version against PHP5.2.9 for those with an updated version

I was reading up on Zarafa and to do a backup looks easy. Looks like I only have to backup the database. Each time I have reloaded ClearOS (ClarkConnect), I have never had a successful backup of my email.

If you are going to do a version for PHP5.2.9, please let me know as I had to downgrade my php in order to get this running. Well worth it though.

Thanks for your hard work on the Tim.

Sean

I am liking this idea of using Zarafa Webmail, although I have run into an issue that you might know a quick fix to. I get the web interface, and I try to login but fail. I have traced the issue, sort of, to a username / password failure. When I do the "zarafa-admin -l" command to see users, the only one that shows up is "SYSTEM". I can only assume this is a system account in ldap, but the rest of my users are not showing up in the list - just system.

Any thoughts on this?

Hi Blaine,

I've been trying to get Zarafa (Thanks Ben....) to work on CC4.3/5.0 and now 5.1 for a few weeks now, but without Tim's help, I figured I would never have gotten as far as he has... kinda gave up... WAY PASSED my skill set! (Thanks again Tim)

It sounds like you tried to install it from the RPM Zarafa provided. (Assuming of Course... YoU did notice the rpm that Tim provided right? Again I assume yes too) Sounds to similar to the same problem I came across when trying to install it from RPM that Zarafa provides. Anyhooo..

Now that I have ClearOS 5.1 RTM installed, I'll working on Samba4, then Zarafa. Don't think I'll have much luck unless we get Zarafa involved. (Could try emailing them too if you like) Since the Lincence rpm requires LDAP 2.3 and ClearOS uses 2.4 we'll wont be able to use the outlook client, but Tim said he has it work... and I believe him... Might just have to wait until they update they program to work with LDAP 2.4.

I have contact Zarafa and I know Peter has too. But me, they don't care about little me! hahaha I might direct them to this forum, it might help motivate them.

I have a client with a mix computer base that would be a perfect testing ground for ClearOS 5.1 and Zarafa, but I fear that I will run out of time before I will have to resort to install SBS2008.... to provide all the feature set that they want... I am trying to install ClearOS as Firewall/gateway, but struggling a bit how to make it all work nicely together. Doesn't help when it's 3:00am and still trying to install everything.

Bed time...

Kevin

It appears your LDAP config isn't set correclty have you double checked the step 3 above, you need to amend each of those fields show above to the items printed in the webconfig LDAP page so that it can correctly query the LDAP databse for users.

Also check /var/log/zarafa/server.log....if it is not configured correclty you may get the following error

As Kevin said, have you used my rebuilt RPM's or the original Zarafa ones?
Last one, I presume you do have in ldap.cfg at /etc/zarafa/

Upon double checking the ldap.cfg file, I realized that I had the ldap_bind_user set correctly, but the search base I illegally had set to the bind user as well, which obviously would cause it to not show any users. Once I set search base to the "dc=page,dc=tld" then it magically gave me users in the "zarafa-admin -l" command. I guess being awake at 4am still trying to get it to work just was not helpful for me.

Just another question on this, and I'm not sure if it's an IMAP issue or a Zarafa Webmail issue. Now that I have Zarafa Webmail setup, it appears to work beautifully without issue. BUT, all the mail I currently have on the server (before installing Zarafa) do not show up in the inbox. Only new mail after the install show up. Is this an IMAP issue, where Postfix is not going to deliver away from Horde? Or a Horde conflict in general?

Glad you now have it working

Just to clarify that the Zarafa inbox / IMAP store is completely seperate from the postfix / ClearOS mailbox setup. If you wish to import all your old emails into the new Zarafa setup then you can use imapsync. I've not tried this myself, so hopefully the following and a bit of googling will get you going
www.zarafa.com/wiki/index.php/Imapsync_m...ting_to_a_new_server
forums.zarafa.com/viewtopic.php?f=10&t=81
wiki.contribs.org/Imapsync#IMAP_migratio...MAP_to_Zarafa.2FIMAP

See the following if you wish to have a more advanced setup where some mail goes to zarafa, and some to cyrus
www.zarafaserver.de/faq/how-can-i-run-bo...zarafa-single-server