Support #377
Installing Zimbra 8 on FreeBSD
Description
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:
- 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/
- Build the dependencies
cd /usr/ports/net/zimbra-rundeps make install clean
- Download the zimbra-rundeps port from an external source (I will include a copy for posterity) and add it to the ports tree:
- 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):
Resources¶
Files