GNet Solutions » FreeBSD Administration

Zimbra is one of the top contenders of Microsoft Exchange services (email, calendar, employee collaboration, etc.) in the Open Source Community. Here is a blurb from their site:

Zimbra Community is an online community and private social networking solution designed to enhance customer support and increase employee productivity.

Unfortunately, the supported Operating Systems for Zimbra are rather old (Ubuntu 12.04 / Debian 5) and it does not support FreeBSD either. I do not want to dedicate a physical box to so I have chosen to build Zimbra 8 from source in a FreeNAS Jail, which is just a FreeBSD 9.2 virtual server. This guide assumes that the server has already been setup and SSH access has been obtained.

(Option 1) Installing the unofficial binary¶

• Start by refreshing the ports tree:
  

  portsnap fetch extract
  pkg install bash
  

• And install a few prerequisite PERL Modules:
  

  pkg install p5-DBI p5-Data-UUID p5-Net-DNS-Resolver-Programmable p5-NetAddr-IP
  

• Then build the Zimbra run dependencies from source:
  1. Download the zimbra-rundeps port from an external source (I will include a copy for posterity) and add it to the ports tree:
     

     mkdir /home/user/src/ && cd /home/user/src/
     wget http://zimbra.imladris.sk/download/ports/usrports_zimbra-rundeps-8.0.8.tgz
     tar xzf usrports_zimbra-rundeps-8.0.8.tgz
     cp -r zimbra-rundeps /usr/ports/net/
     

  2. Build the dependencies
     

     cd /usr/ports/net/zimbra-rundeps
     make install clean
     

• Next download and install Zimbra 8.0.8 (I will include a copy for posterity)
  

  cd /home/user/src
  wget http://zimbra.imladris.sk/download/zimbra-packages/IRONMAIDEN-808/zcs-8.0.8_GA_6038.FreeBSD_amd64.20140410114750.tgz
  tar xzf zcs-8.0.8_GA_6038.FreeBSD_amd64.20140410114750.tgz
  cd zcs-8.0.8_GA_6038.FreeBSD_amd64.20140410114750/
  ./FreeBSD_amd64.install.sh
  y
  y
  

NOTE: This will also prompt to automagically install the zimbra-rundep dependency. Select Y to continue installing Zimbra.

Configure Zimbra¶

When the install finished, a prompt will appear. The admin password needs to be set before continuing:

3
4
SuperSecretPassword
r
a

When the installation finished, point a web browser at the newly create Zimbra server and login using the admin credentials provided during configuration.

NOTE: To download the Desktop Client Applications, go to http://zimbra.example.com/downloads/index.html.

This method worked to get Zimbra installed; the following versions are recorded in hopes to documents building Zimbra fully from source.

(Option 2) Building Zimbra from git source¶

WARNING: I have yet been able to successfully build Zimbra from source on FreeBSD 9.2.

• To begin, we need to install some dependencies.
  

  pkg install git bash wget p5-DBI p5-Data-UUID p5-Net-DNS-Resolver-Programmable p5-NetAddr-IP libltdl
  

• Next refresh the ports tree:
  

  portsnap fetch extract
  pkg install bash
  

Add the Zimbra git development keys:¶

• Obtain the git ssh access keys
  

  mkdir -p /tmp/zimbra-git
  cd /tmp/zimbra-git
  wget http://files2.zimbra.com/downloads/git-fusion/zimbra-git-ssh.tgz
  tar xfz zimbra-git-ssh.tgz
  

• Add the access keys to your own user account:
  

  cd ~/.ssh
  cp /tmp/zimbra-git/id_rsa_git* .
  

• Add the following ~/.ssh/config. Create the file if it doesn't exist:
  

  Host zimbra-git
    User public
    Hostname git.zimbra.com
    IdentityFile ~/.ssh/id_rsa_git
    IdentitiesOnly yes
    Port 1067
  

Build the Zimbra dependencies from source:¶

• Download the zimbra-builddeps port from an external source (I will include a copy for posterity) and add it to the ports tree:
  

  portsnap fetch extract
  cd /usr/ports/mail
  wget http://zimbra.imladris.sk/download/ports/usrports_zimbra-builddeps-8.0.8.tgz
  wget http://zimbra.imladris.sk/download/ports/usrports_zimbra-rundeps-8.0.8.tgz
  tar xzf usrports_zimbra-builddeps-8.0.8.tgz
  tar xzf usrports_zimbra-rundeps-8.0.8.tgz
  

• Build the Zimbra build dependencies
  

  cd /usr/ports/mail/zimbra-builddeps
  make install clean
  

• Build the Zimbra run dependencies
  

  cd /usr/ports/mail/zimbra-rundeps
  make install clean
  

• Next download the current release of Zimbra:
  

  mkdir ~/git
  cd ~/git
  git clone git@zimbra-git:zimbra-foss
  

  
  NOTE: This took nearly 12GB of storage, so be forewarned.
• Change the current branch to the most current stable version
  

  cd ~/git/zimbra-foss
  git checkout ironmaiden-foss
  

• Then download the FreeBSD patch for Zimbra and patch the install:
  

  cd ~/git
  wget http://zimbra.imladris.sk/download/patches/IRONMAIDEN-808-FreeBSD.patch
  cd zimbra-foss
  patch -p1 -s < ../IRONMAIDEN-808-FreeBSD.patch
  chmod 755 ZimbraBuild/rpmconf/Spec/Scripts/FreeBSD/*
  mkdir /opt/zimbra
  chown zimbra:zimbra /opt/zimbra
  

• Download the Java Cryptographic Extension
  

  mkdir -p ~/git/zimbra-foss/ThirdPartyBuilds/i386/java/jce
  mkdir ~/jce && cd ~/jce
  cp /path/to/jce_policy-6.zip
  unzip jce_policy-6.zip
  cp -r ~/jce ~/git/zimbra-foss/ThirdPartyBuilds/i386/java/
  

• Compile and install Zimbra
  

  cd ~/git/zimbra-foss/ZimbraBuild
  ./buildZCS.sh -t
  

This will begin a process to automatically resolve any further dependencies.

• I used the following CPAN repository, since I am not a fan of yahoo (the default):

http://ftp.osuosl.org/pub/CPAN/

Resources¶

• https://wiki.zimbra.com/wiki/Zimbra_on_FreeBSD
• http://www.zimbra.com/forums/installation/61938-ironmaiden-8-0-3-ported-freebsd-2.html
• https://wiki.zimbra.com/wiki/Building_Zimbra_using_Git
• http://wiki.zimbra.com/wiki/Building_IRONMAIDEN_8.0.3_on_FreeBSD_9.1_amd64