Zimbra on FreeBSD

Revision as of 16:06, 28 February 2010 by Solko (talk | contribs) (General information)

General information

The Perforce cache gives users access to download and build/modify Zimbra source code for Open Source products. Building Zimbra Collaboration Suite from Zimbra's Perforce cache requires advanced knowledge of troubleshooting. It is not available for Network Edition components. Changes cannot be committed to the Perforce cache.

By building Zimbra, you agree to Zimbra's licensing terms. Building from source is not covered under the ZEUL, unlike pre-compiled binaries, but rather the YPL.

By fetching Zimbra from zimbra.imladris.sk, you agree to Zimbra's licensing terms. I am not good at legal stuff, screw it.

Technical support for source building can be found in the Zimbra Developers forum.

Zimbra does not support FreeBSD out of the box and there are no plans for the future support (or so we all heard). I tried to integrate FreeBSD into source tree as much as possible so the same version should compile fine on other supported systems.

GNR-601 *was* the latest 6.0 series release at the time of writing this document. Current version and changelist can be found on Pmweb.

This document summarizes everything related to GNR-601 on FreeBSD-7, however patched GNR-601 will build on FreeBSD-6 and FreeBSD-8 as well.


Please, always check zimbra FreeBSD thread for the latest news!

Patch notes

This is a complete rework of GNR-601 source tree and it sometimes makes things better than the original. Some notable changes:

1) openssl, bdb, libtool, popt, expat, pcre, libxml2, tcmalloc are used from base system.

Rest is too Zimbra specific and would be of no other use on the system.

2) most perl modules are used from base system. Those left unchanged are:

Getopt::Easy - not in /usr/ports and it's not really used at all besides one tiny script (no idea why not using Getopt::Long like usual),

DBD::mysql - mysql specific includes/libs not part of base,

Net-LDAPapi - ldap/cyrus-sasl specific includes/libs not part of base,

Mail-SpamAssassin - requires different datadir.

3) FreeBSD specific includes in ZimbraBuild/defs/FreeBSD* and ZimbraBuild/defs/ThirdParty/*

4) package generation is handled by pkg_create so we install real FreeBSD specific packages.

5) complete rework of PRE-INSTALL/POST-INSTALL/DEINSTALL scripts in ZimbraBuild/rpmconf/Spec/Scripts/FreeBSD.

6) every su - zimbra -c call has been replaced by sudo -u zimbra -i -- -c call because su+bash is hitting a race condition on FreeBSD-7.2 (and other systems.. like Linux) which causes some scripts to hang up indefinitely.

changed back to su - zimbra -c as only FreeBSD-8+ is supported from now on (kept here as a reminder in case someone hits the bug again).

7) libexec/zmfixperms now fixes all needed permissions. It is called in every POST-INSTALL script.

Building GNR-601 on FreeBSD-7.2_amd64

Building_GNR_on_FreeBSD_7.2_amd64

Installing GNR-601 on FreeBSD-7.2_amd64 without building

Installing_GNR_on_FreeBSD_7.2_amd64

Building GNR-601 on FreeBSD-7.2_i386

Building_GNR_on_FreeBSD_7.2_i386

Installing GNR-601 on FreeBSD-7.2_i386 without building

Installing_GNR_on_FreeBSD_7.2_i386

Suggested tweaks

1) cpu spikes every minute or two:

su - zimbra
zmlocalconfig -e zmmtaconfig_interval=6000
zmprov mcf zimbraLogRawLifetime 7d
zmprov mcf zimbraLogSummaryLifetime 30d
/opt/zimbra/libexec/zmlogprocess
sed -I "" -e s'|.* \* \* \* \* /opt/zimbra/libexec/zmstatuslog|\*/60 \* \* \* \* /opt/zimbra/libexec/zmstatuslog|' /var/cron/tabs/zimbra

TO DO

1) create a Zimbra FreeBSD specific start-up script in /usr/local/etc/rc.d.

I failed miserably at the attempt so please someone supply somehow..

Troubleshooting

This is the part where opensource community unites to solve all the problems!

New versions

I will try to keep this project real. If you don't see the new version here, please write me a request. New versions require the same steps as the old versions unless stated otherwise (e.g.: just substitute '601' with '602').

1) GNR-601:

patch GNR-601 -> GNR-601 FreeBSD

GNR-601 FreeBSD_7_amd64 packages

2) GNR-602:

patch GNR-602 -> GNR-602 FreeBSD

GNR-602 FreeBSD_7_amd64 packages

3) GNR-603:

patch GNR-603 -> GNR-603 FreeBSD

GNR-603 FreeBSD_7_amd64 packages

GNR-603 FreeBSD_8_amd64 packages

4) GNR-604:

patch GNR-604 -> GNR-604 FreeBSD

GNR-604 FreeBSD_8_amd64 packages


READ ME - WARNING - READ ME

1) sudo versions >= 1.7 do not work:

sudo -u zimbra -l -- -lc command

fails so please use lower version until someone finds the fix!


--Solko 10:07, 9 February 2010 (UTC)


Verified Against: ZCS 6.0.x on FreeBSD 7 Date Created: 10/4/2009
Article ID: https://wiki.zimbra.com/index.php?title=Zimbra_on_FreeBSD Date Modified: 2010-02-28



Try Zimbra

Try Zimbra Collaboration with a 60-day free trial.
Get it now »

Want to get involved?

You can contribute in the Community, Wiki, Code, or development of Zimlets.
Find out more. »

Looking for a Video?

Visit our YouTube channel to get the latest webinars, technology news, product overviews, and so much more.
Go to the YouTube channel »

Jump to: navigation, search