How to Install Zimbra Collaboration Suite

8/8/2019 How to Install Zimbra Collaboration Suite

1/22

How To Install Zimbra Collaboration Suite (ZCS) On

Ubuntu

This guide shows how to install the Zimbra Collaboration Suite (ZCS) on Ubuntu 6.10 (Edgy

Eft) and 6.06 (Dapper Drake) server systems. Zimbra is a full-featured, open sourcecollaboration suite - email, group calendaring, contacts, and web document management andauthoring. It has a feature-rich AJAX web interface and is compatible with clients such asMicrosoft Outlook, Apple Mail, and Novell Evolution so that mail, contacts, and calendar itemscan be synchronised from these to the ZCS server. It can also be synchronized to many mobiledevices. ZCS makes use of many existing open source projects such as Postfix, MySQL, andOpenLDAP.

I do not issue any guarantee that this will work for you!

1 Preliminary Note

Please download the Ubuntu 6.10 or 6.06 server CD from http://www.ubuntu.com/downloadandinstall a basic Ubuntu system with it. Don't install/enable any services (e.g. like LAMP or DNS)- if you do, you'll have to disable them later on as they might interfere with Zimbra!

After the installation of the base system, we'll do some additional configuration, e.g. enable theroot account, install an SSH daemon, apply a static IP address and a hostname to the system.

I will use the hostname mail.example.com in this tutorial together with the IP address

192.168.0.110. Adjust this to your needs, but make sure that mail.example.com has a valid MXrecord in DNS (Zimbra needs this!). I assume you want to create email accounts forexample.com instead of mail.example.com, so you should have an MX record for example.comas well.

In this example the Zimbra server is in a local network (192.168.0.110 is a private IP address)behind a router, so make sure you use the router's public IP address (1.2.3.4 in this example) inthe DNS records - of course this IP address should be static. If you have a dynamic IP address,you could use a service such as DynDNS.org, but keep in mind that most public IP addresses areblacklisted nowadays.

So if you use BIND on the authoritative name server for example.com, you should havesomething like this in example.com's zone file:

[...]mail.example.com. A 1.2.3.4mail.example.com. MX 0 mail.example.com.example.com. MX 0 mail.example.com.[...]
http://www.zimbra.com/http://www.ubuntu.com/downloadhttp://www.ubuntu.com/downloadhttp://www.dyndns.com/http://www.ubuntu.com/downloadhttp://www.dyndns.com/http://www.zimbra.com/


2/22

If your Ubuntu server is behind router, make sure that you forward at least port 25 from yourrouter to your Ubuntu server.

If your Ubuntu server is in a data center, it most likely has a static public IP address and ahostname, so you can skip chapter 1.3, but still you must make sure that this hostname has a

valid MX record.

1.1 Enable The root Account

To enable the root account, run

sudo passwd root

and specify a password for root.

Afterwards, become root by running

su

All following commands in this tutorial are executed as root (unless something else is written)!

1.2 Install The SSH Daemon

Just run

apt-get install ssh openssh-server

to install the SSH daemon.

1.3 Apply A Static IP Address And Hostname

Edit/etc/network/interfaces and adjust it to your needs (in this example setup I will use the IP

address 192.168.0.110):

vi /etc/network/interfaces

# This file describes the network interfaces available on your system# and how to activate them. For more information, see interfaces(5).

# The loopback network interface


3/22


4/22

1.4 Disable The Ubuntu CD In /etc/apt/sources.list

I like to install all packages over the internet instead of from the Ubuntu CD, therefore I disable

the Ubuntu CD in /etc/apt/sources.list now:

vi /etc/apt/sources.list

On Ubuntu 6.10 ("Edgy Eft"), comment out this line:

[...]#deb cdrom:[Ubuntu-Server 6.10 _Edgy Eft_ - Release i386(20061025.1)]/ edgy main restricted[...]

On Ubuntu 6.06 ("Dapper Drake"), it's this line:

[...]#deb cdrom:[Ubuntu-Server 6.06 _Dapper Drake_ - Release i386(20060531)]/ dapper main restricted[...]

Then update the packages database by running

apt-get update

1.5 Disable Services

If this is no fresh system and you have some services already running (such as Postfix, Apache,OpenLDAP), you must disable them first before installing Zimbra. Otherwise Zimbra will fail toinstall.

For example, to disable Postfix on your system, run

/etc/init.d/postfix stopupdate-rc.d -f postfix remove

The commands for the other services are similar.


5/22

2 Change The Default Shell (Ubuntu 6.10 Edgy Eft Only)

If you are on Ubuntu Edgy Eft, most probably /bin/sh is a symlink to /bin/dash, however we need/bin/bash, not /bin/dash. Therefore we do this:

rm -f /bin/shln -s /bin/bash /bin/sh

If you don't do this, you will most likely get an error like this during the Zimbra installation:

Creating SSL certificate...DoneInitializing ldap...TLS: error:02001002:system library:fopen:No such file or directorybss_file.c:352TLS: error:20074002:BIO routines:FILE_CTRL:system lib bss_file.c:354TLS: error:140B0002:SSL routines:SSL_CTX_use_PrivateKey_file:system lib ssl_rsa.c:648main: TLS init def ctx failed: -1

ERROR - failed to start slapd

FAILED (1)

On Ubuntu Dapper Drake, /bin/sh points to /bin/bash by default, so everything is ok.

3 Install Zimbra

First let's install some prerequisites for Zimbra:

apt-get install curl fetchmail libpcre3 libgmp3c2 libexpat1 libxml2 libtie-ixhash-perl

Afterwards, go to http://www.zimbra.com/community/downloads.htmland download the Ubuntu6 (.tgz) package to /usr/src, for example like this:

cd /usr/srcwget http://kent.dl.sourceforge.net/sourceforge/zimbra/zcs-4.5.3_GA_733.UBUNTU6.tgz

(Replace the download URL with the one you get from SourceForge.)

Afterwards, unpack the Zimbra .tgz file and start the installer:

tar xvfz zcs-4.5.3_GA_733.UBUNTU6.tgzcd zcs/./install.sh

The installer will ask a few questions. Answer them like this:
http://www.zimbra.com/community/downloads.htmlhttp://www.zimbra.com/community/downloads.htmlhttp://www.zimbra.com/community/downloads.html


6/22

Operations logged to /tmp/install.log.4416Checking for existing installation...

zimbra-ldap...NOT FOUNDzimbra-logger...NOT FOUNDzimbra-mta...NOT FOUND

zimbra-snmp...NOT FOUNDzimbra-store...NOT FOUNDzimbra-apache...NOT FOUNDzimbra-spell...NOT FOUNDzimbra-core...NOT FOUND

PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THE SOFTWARE.ZIMBRA, INC. ("ZIMBRA") WILL ONLY LICENSE THIS SOFTWARE TO YOU IF YOUFIRST ACCEPT THE TERMS OF THIS AGREEMENT. BY DOWNLOADING OR INSTALLING

THE SOFTWARE, OR USING THE PRODUCT, YOU ARE CONSENTING TO BE BOUNDBYTHIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THISAGREEMENT, THEN DO NOT DOWNLOAD, INSTALL OR USE THE PRODUCT.

License Terms for the Zimbra Collaboration Suite:http://www.zimbra.com/license/collaboration_suite_collective_license_1.0.html

Press Return to continue


7/22

2) Ldap master host: mail.example.com3) Ldap port: 3894) Ldap password: set5) zimbra-ldap: Enabled6) zimbra-store: Enabled

+Create Admin User: yes+Admin user to create: [email protected]******* +Admin Password UNSET

+Enable automated spam training: yes+Spam training user: [email protected]+Non-spam(Ham) training user: [email protected]+Global Documents Account: [email protected]+SMTP host: mail.example.com+Web server HTTP port: 80+Web server HTTPS port: 443+Web server mode: http

+Enable POP/IMAP proxy: no+IMAP server port: 143+IMAP server SSL port: 993+POP server port: 110+POP server SSL port: 995+Use spell check server: yes+Spell server URL: http://mail.example.com:7780/aspell.php

7) zimbra-mta: Enabled8) zimbra-snmp: Enabled9) zimbra-logger: Enabled10) zimbra-spell: Enabledr) Start servers after configuration yess) Save config to filex) Expand menuq) Quit

Address unconfigured (**) items (? - help)


8/22

10) Web server HTTP port: 8011) Web server HTTPS port: 44312) Web server mode: http13) Enable POP/IMAP proxy: no14) IMAP server port: 143

15) IMAP server SSL port: 99316) POP server port: 11017) POP server SSL port: 99518) Use spell check server: yes19) Spell server URL: http://mail.example.com:7780/aspell.php

Select, or 'r' for previous menu [r]


9/22


10/22

going to show some basic screenshots here, but no help on how to use Zimbra. To learn how touse Zimbra, please refer to http://www.zimbra.com/community/documentation.html andhttp://wiki.zimbra.com.

4.1 The Administration Console

You can now open a browser and open the Zimbra Administrator web interface. The URL ishttps://mail.example.com:7071/zimbraAdmin. Log in with the username admin and the passwordyou specified during the Zimbra installation:

This is how the admin panel looks like:
http://www.zimbra.com/community/documentation.htmlhttp://wiki.zimbra.com/http://www.zimbra.com/community/documentation.htmlhttp://wiki.zimbra.com/


11/22

You can find all pre-configured email addresses under Accounts:


12/22

If you want to add a new domain (e.g. example.com because you want email addresses of theform [email protected] instead of [email protected]), click on Domains and then on

New:


13/22

Create example.com:


14/22

Afterwards, example.com is listed in the domains list:


15/22

To create a new user, go to Accounts and click on New:


16/22

Follow the wizard to create a new email account. Take care that you select the right domain(example.com vs. mail.example.com):


17/22

Afterwards, mark the new account in the accounts list and click on Edit:


18/22

Specify a password for the new account on the General Information tab and click on Save:


19/22

4.2 The User Webinterface

Now that you've created a normal user account, you can log out of the admin panel and go tohttp://mail.example.com. Log in with the email address and the password of the new account:


20/22

This is how the user webinterface looks like. You have tabs to manage your emails, addressbook, calendar, documents, etc.


21/22

5 Uninstall Zimbra

If you want to uninstall Zimbra, do it like this:

Go the the Zimbra installation directory (I hope you didn't delete it):

cd /usr/src/zcs

Then run

./install.sh -u

and delete the Zimbra installation directory afterwards:

cd /usr/srcrm -rf zcs


22/22

How To Install Zimbra Collaboration Suite (ZCS) On Ubuntu - Page 2

THANK YOU!!!Submitted by Oniemusha (not registered) on Thu, 2010-07-15 09:25.This is a nice site who really are linux noobz. i just followed the instruction and voila my zimbra

mail is online. Again, thank you for a nice work!!!!reply | view as pdfMany many thanks to writerSubmitted byryazkhan (registered user) on Sat, 2008-04-05 04:56.

Many many thanks to writer of this greate how to, it is really helpfull and it just works

I am new to this forum so let me be part of this please

I followed this how to and got my zimbra running without any major issue. I cannot figure outwhere this info should go /etc/hosts or/etc/resolv.confor somewhere else

[...]

mail.example.com. A 1.2.3.4

mail.example.com. MX 0 mail.example.com.

example.com. MX 0 mail.example.com.

[...]

so followed rest and it still worked very nice but I was not able to browse by domainmail.example.com and that is why I could got any email or reply I was successfull in sendingmails, but I used IP instead and that worked. I am really thankfull to writer and asking for littlehelp to clear where this stuff stated above suppose to go and if possible give me exact files

contents which will be greate help. Thank you in advance

[email protected]
http://www.howtoforge.com/installing_zimbra_collaboration_suite_on_ubuntu_p3#comment-24603http://www.howtoforge.com/comment/reply/1990/24603http://www.howtoforge.com/subscriptionhttp://www.howtoforge.com/installing_zimbra_collaboration_suite_on_ubuntu_p3#comment-4204http://www.howtoforge.com/forums/member.php?u=37508http://www.howtoforge.com/forums/member.php?u=37508http://www.howtoforge.com/subscriptionhttp://www.howtoforge.com/installing_zimbra_collaboration_suite_on_ubuntu_p3#comment-24603http://www.howtoforge.com/comment/reply/1990/24603http://www.howtoforge.com/subscriptionhttp://www.howtoforge.com/installing_zimbra_collaboration_suite_on_ubuntu_p3#comment-4204http://www.howtoforge.com/forums/member.php?u=37508