Zimbra on FreeBSD
README FIRST
Please, do not start random threads in zimbra/installation forums AND if so, please, post a link in the dedicated sticky thread AND/OR send me an email, contact me on ICQ/Skype (have a look at my forum profile for more info). Most problems can be resolved within minutes and I am subscribed only to the main thread. Keep in mind that zimbra on FreeBSD is still officially unsupported and that means you won't get help from zimbra team.
Most people (like myself) got tons of other activities (like family/work) so they don't have time to read excessive amount of data.
If you spot a mistake, please, let me know - I am neither psychic or omnipotent.
If anyone wonders, this is not a joke :-).
--Solko 23:30, 29 March 2010 (UTC)
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 and SUN'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') but since I am using FreeBSD-8_amd64 everywhere I won't provide binary packages (either dependencies or zimbra itself) for other/future versions. When in doubt you can always browse the small zimbra repository at zimbra.imladris.sk to see the list of available files.
1) GNR-601:
patch GNR-601 -> GNR-601 FreeBSD
GNR-601 FreeBSD-7_i386 packages
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
5) GNR-605:
patch GNR-605 -> GNR-605 FreeBSD
GNR-605 FreeBSD-8_amd64 packages
GNR-605 FreeBSD-8_amd64 run dependencies (all packages) or build yourself (place this to /usr/ports/mail/)
GNR-605 FreeBSD-8_amd64 build dependencies (all packages including zimbra-rundeps) or build yourself (place this to /usr/ports/mail/)
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!
Please, note that this is no longer relevant for GNR-605+.
--Solko 16:07, 28 February 2010 (UTC)