Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Global Open Versity
Systems Integration Hands-on Labs Training Manual
Mastering Zimbra Collaboration Suite (ZCS) 7.0 Deployment on
Ubuntu 10.04 LTS Server
Kefa Rabah
Global Open Versity, Vancouver Canada
krabah@globalopenversity.org
www.globalopenversity.org
Table of Contents Page No.
MASTERING ZIMBRA COLLABORATION SUITE (ZCS) 7.0 DEPLOYMENT ON UBUNTU 10.04 LTS
SERVER 3
Introduction 3
Part 1: Install Ubuntu 10.04 LTS 4
Step 1: Zimbra requirements: 4
1.1 Production & Testing environment 4
Step 2: Assumptions 4
Step 3: Update Ubuntu 10.04 Operating Systems 5
Part 2: Perform Additional Optional Tasks 5
Step 1: Configure Network Interface 5
Step 2: Change system hostname 6
Part 3: Install DNS Server 7
Step 1: Install & Configure Bind9 DNS Server 7
Part 4: Install Zimbra Collaboration Suite (ZCS) Server 11
Step 1: Install ZCS Server 11
Step 2: Accessing Zimbra mail server 19
Step 3: Adding New Users Account 22
Part 5: Accessing the Email via VMware Zimbra Web Mail Client 28
Step 1: Accessing Email via Zimbra Web Client 28
Step 2: Composing a New Mail 29
Step 3: Configuring GAL for Mail Sync 31
3.1 Internal GAL Settings 32
3.2 External GAL Settings 33
Step 4: Other Zimbra Features 33
4.1 How to Deploy Zimlet in Zimbra 33
Step 5: View LDAP 34
Part 6: Install & Configure Thunderbird Mail Client with Zimbra 36
Step 1: Install Thunderbird Mail client 36
Step 2: Using Zindus to Configure Google and Zimbra contact sync for Thunderbird 40
2.1 Configure Zindus to Sync your Google Mail 42
Step 3: Configuring Directory Service (LDAP) on Thunderbird Mail client 42
1
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Step 4: Check & Verify Directory Service (LDAP) 44
Part 7: Configuring and Using Outlook 2007 with Zimbra 47
Step 1: Install Microsoft Office Outlook 2007 47
Step 2: Install and configure Windows 7 NIC 48
Step 3: Setup MS Outlook 2007 49
Step 4: Configure the Address Book for LDAP on MS Outlook 2007 on Zimbra 54
Step 4: Searching Contact list using LDAP powered Address Book 56
4.1 Using Addressbook and Contact to Send New Mail 59
Part 8: Uninstall Zimbra 61
Part 9: Troubleshooting Port Conflict 61
Method 1: Solving Port Conflict Problem 61
Method 2: Alternative Solution to Conflict in Ports 62
Part 10: Hands-on Lab Assignments 62
Ubuntu Server Administration Training 62
A GOV Open Access Technical Academic Publications
Enhancing education & empowering people worldwide through eLearning in the 21st Century
2
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Global Open Versity
Enterprise Architecture Hands-on Labs Training Manual
Mastering Zimbra Collaboration Suite (ZCS) 7.0 Deployment
on Ubuntu 10.04 LTS Server
By Kefa Rabah, krabah@globalopenversity.org November, 2011 GTS Institute
Introduction
Zimbra messaging server is the leading alternative to Microsoft Exchange server and, the good part, its
open source software for email and collaboration - email, group calendar, and contacts, instant
messaging, file storage and web document management, to-do lists and more. Best of all (for Windows
folks) it works with Microsoft Outlook. The Zimbra email and calendar server is available for Linux, Mac
OS X and virtualization platforms. Zimbra syncs to smartphones (iPhone, BlackBerry) and desktop clients
like Outlook and Thunderbird. Zimbra also features archiving and discovery for compliance. Zimbra can be
deployed on-premise or as a hosted email solution. Zimbra comes with its own Web Interface (an
improvement on cf. OWA) and a portable interface called “Zimbra Desktop”. Zimbra Desktop has off-line
mode, right click functions and is responsive enough even for the inpatient users.
Zimbra was created by Zimbra Inc. which was ultimately purchased by Yahoo! and now subsequently by
VMWare. It includes an email system with POP/IMAP and webmail access, calendaring, contacts, notes
and document collaboration. The system has very modular components: authentication handled by LDAP
Server – SMTP and filtering services by MTA Server – UI and storage for webmail by the Mailbox
Server - routing by optional Proxy Servers. You can scale by having multiple LDAP servers.
To-date, Zimbra Collaboration Server (ZCS) is the most capable open source email and collaboration
suite available today. Far outstripping what is possible with simple open source mail servers, Zimbra
provides organizations major productivity boosts with global address lists, shared calendars and
document management on the web or offline with Zimbra Desktop. Support for standard protocols enables
use of virtually any desktop client or device for added end user flexibility.
Here are the steps required to successfully install Zimbra 7.1.3 on Ubuntu 10.04 LTS Lucid Lynx server.
The system will work perfectly even after its rebooted (no MTA errors). I have used these steps to install
Zimbra on several servers and all work perfectly. We hope this training guide will save others the time of
hunting around forums. Also it’s a good idea to have the DNS A records and MX records setup before you
start the installation.
A final note is to remember that email archiving is something every business needs to take very seriously.
not only for compliance, but also for your own business continuity, storage efficiency and productivity,
therefore, it crucial that you have email archiving storage in place for your enterprise.
3
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Hands-on Lab Session
In this Hands-on Labs, you will learn how to install Ubuntu 10.04 LTS Lucid Lynx server and prepare it for
the installation of Zimbra Collaboration Suite (ZCS) server. ZCS requires at least 500 MB RAM or more.
You’ll also learn how to perform post-installation configuration e.g., upgrade the system with new patches
and bug fixes, configure static IP address from dynamic one to static, change the computer hostname,
modify hosts file, followed by installation of DNS server using Bind9. Next, you will learn how to install
ZCS messaging followed by configuration. Configure Zimbra LDAP to power our addressbook and
centralized Identity Management. Configure LDAP to power Mozilla Thunderbird and Outlook 2007 mail
clients’ addressbook and contact management. Upon completion of this lab session you should have
gained a capability and expertise to install and maintain ZCS. The entire lab training was performed on
VMware. But you can also use the open source VirtualBox from Oracle.
Part 1: Install Ubuntu 10.04 LTS
Step 1: Zimbra requirements:
1.1 Production & Testing environment
Evaluation and Testing:
• Intel/AMD 32-bit or 64-bit CPU 1.5 GHz
• 1 GB RAM
• 5 GB free disk space for software and logs
• Temp file space for installs and upgrades
• Additional disk space for mail storage
Production environments:
• Intel/AMD CPU 32-bit 2.0 GHZ+.
• For large deployments (more than 2000 users), 64-bit OS is recommended.
• Minimum - 2 GB RAM (Recommend - 4 GB).
• Temp file space for installs and upgrades.
• 10 GB free disk space for software and logs (SATA or SCSI for performance, and
RAID/Mirroring for redundancy).
• Additional disk space for mail storage.
Note: Firewall Configuration should be set to: No firewall, and the Security Enhanced Linux
(SELinux) should be disabled. You can find detailed requirements in
Step 2: Assumptions
1. It’s assumed that you have a good understanding of Linux operating system and its working
environment. It’s also assumed that you know how to install and configure Ubuntu Linux server, if not
go ahead and pop over to scribd.com and check out a good hands-on manual entitled “Step-By-Step
Install Guide Ubuntu 10.04 LTS (Lucid Lynx) Server” to get you started.
2. In the next section, we’re going to perform other post-installation work like system upgrade and etc.
4
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Step 3: Update Ubuntu 10.04 Operating Systems
It is useful to update your system with the latest components and system patches. The first command
below asks Ubuntu to update its database of available packages, and the second command installs the
latest packages based on your current configuration. We run the upgrade command twice to ensure that
any packages that may have post-upgrade dependencies also have an opportunity to be upgraded.
1. From the command line, enter the following commands, one at a time.
$ sudo apt-get update
$ sudo apt-get -u upgrade
2. We’re done with this section
3. You’re now ready to begin any other application installation as desired!
Part 2: Perform Additional Optional Tasks
Step 1: Configure Network Interface
In this section, we are going to check and modify the network interface to modify it from dhcp to static IP
address on eth0 interface. If your Ubuntu System by default is set to use DHCP, you will want to change
it to a static IP address here is simple tip
To do this, perform the following procedure:
1. Fire up your favorite Text editor and open and modify ″/etc/network/interfaces″ file, with the
result shown in Fig. 1.
$ sudo nano /etc/network/interfaces
Note: If you are using DHCP for your primary network card which is usually eth0, you will see the
following lines, see Fig. 1
auto eth0
iface eth0 inet dhcp
5
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Fig. 1
Note: as you can see from Fig. 1 above, it’s using DHCP right now.
2. Next, we are going to change DHCP to static, and then there are a number of options that should add
and here is the example and you can change these settings according to your network settings, with
the final result shown below:
auto eth0
iface eth0 inet static
address 192.168.83.50
netmask 255.255.255.0
network 192.168.83.0
broadcast 192.168.83.255
gateway 192.168.83.2
3. Restart the networking service using the following command
$ sudo /etc/init.d/networking restart
4. To check you server IP address, issue the ifconfig command.
5. We’re done with this section
Step 2: Change system hostname
If at the end of the initial installation you decide that you now need a different hostname, you can do so, by
editing the /etc/hostname file
1. Fire-up your favourite Text editor and open /etc/hostname file
2. Change the hostname as desired and save the file and exit
3. Next, we need to edit the /etc/hosts file to reflect our new change
4. Reboot the system for the new changes to take effect
5. We’re done with this section
6
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Part 3: Install DNS Server
In this section it’s assumed that you know how to install and configure a DNS Server on a Linux machine,
if not, then check out our excellent Hands-On Labs training manual, entitled “Using Webmin and Bind9 to
Setup DNS Server on Linux” to get you started. Here we’re going to use Webmin and Bind9 to deploy
DNS Server.
Step 1: Install & Configure Bind9 DNS Server
Assumption
In also assumed that you know how to install and configure a DNS Server on a Linux machine, if not, then
check out our excellent Hands-On Labs training manual from Docstoc.com, entitled “Using Webmin and
Bind9 to Setup DNS Server on Linux” to get you started. Here we’re going to use Webmin and Bind9 to
deploy DNS Server.
1. Use apat-get to download and install Bind9, if it’s not already installed, by issuing the following
command:
sudo apt-get install bind9 –y
2. Edit "/etc/hosts" file to reflect the correct hostname, as shown in Fig. 3.
Fig. 3
3. Edit "/etc/resolv.conf" file to reflect the correct namesearch, domain and search, as shown
in Fig. 4.
7
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Fig. 4
4. Install Webmin web admin tool.
5. Now fire-up your browser and point it to Webmin admin page: http://localhost:10000. Next click on
Servers link on the left-hand pane and then click BIND DNS Server. On the right pane, scroll down to
the Existing DNS Zones heading, as shown in Fig. 5.
Fig. 5
6. Next, configure the DNS server, and when done, you should have a modified Existing DNS Zones
with two additional icons, as shown in Fig. 6.
8
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Fig. 6
7. Now open a new terminal window and test that your DNS server is configured correctly using "dig"
and "nslookup" commands, as shown in Figs. 7, and 9, respectively.
Fig. 8
9
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
8. And similarly for "nslookup", as shown in Fig. 9.
Fig. 9
9. Now open a new terminal window and test that your DNS server is configured correctly as mail server
using "dig mx"
Fig. 9
10. You can also start/stop/restart Bind9 from command-line as follows:
sudo /etc/init.d/bind9 start/stop/restart
11. We’re done with this section
10
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Part 4: Install Zimbra Collaboration Suite (ZCS) Server
Step 1: Install ZCS Server
1. Hope over to http://www.zimbra.com/downloads/os-downloads.html website and download the
latest stable package which at the time of writing this lab manual was:
"zcs-7.1.3_GA_3346.UBUNTU10_64.20110928134610.tgz"
2. Copy the Zimbra file into /usr/src/ directory:
cp zcs-7.1.3_GA_3346.UBUNTU10_64.20110928134610.tgz /usr/src/
3. Change into the /usr/src/ directory and uncompress file:
tar -xzvf zcs-7.1.3_GA_3346.UBUNTU10_64.20110928134610.tgz
4. Change to the uncompressed directory:
cd zcs-7.1.3_GA_3346.UBUNTU10_64.20110928134610
5. Start the installation by running ″./install.sh″ and follow the on screen instructions.
sudo ./install.sh
Note: most of the time, the default is simply accepted indicated by the ↵ (i.e., by hitting the Enter key)
in the sample session below.
netadmin@server01:/usr/src/zcs-7.1.3_GA_3346.UBUNTU10_64.20110928134610$ sudo
./install.sh
Operations logged to /tmp/install.log.3163
Checking for existing installation...
zimbra-ldap...NOT FOUND
zimbra-logger...NOT FOUND
zimbra-mta...NOT FOUND
zimbra-snmp...NOT FOUND
zimbra-store...NOT FOUND
zimbra-apache...NOT FOUND
zimbra-spell...NOT FOUND
zimbra-convertd...NOT FOUND
zimbra-memcached...NOT FOUND
zimbra-proxy...NOT FOUND
zimbra-archiving...NOT FOUND
zimbra-cluster...NOT FOUND
zimbra-core...NOT FOUND
PLEASE READ THIS AGREEMENT CAREFULLY BEFORE USING THE SOFTWARE.
ZIMBRA, INC. ("ZIMBRA") WILL ONLY LICENSE THIS SOFTWARE TO YOU IF YOU
FIRST ACCEPT THE TERMS OF THIS AGREEMENT. BY DOWNLOADING OR INSTALLING
THE SOFTWARE, OR USING THE PRODUCT, YOU ARE CONSENTING TO BE BOUND BY
THIS AGREEMENT. IF YOU DO NOT AGREE TO ALL OF THE TERMS OF THIS
AGREEMENT, THEN DO NOT DOWNLOAD, INSTALL OR USE THE PRODUCT.
11
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
License Terms for the Zimbra Collaboration Suite:
http://www.zimbra.com/license/zimbra_public_eula_2.1.html
Do you agree with the terms of the software license agreement? [N] y
Checking for prerequisites...
FOUND: NPTL
FOUND: netcat-openbsd-1.89-3ubuntu2
FOUND: sudo-1.7.2p1-1ubuntu5
FOUND: libidn11-1.15-2
FOUND: libpcre3-7.8-3build1
FOUND: libgmp3c2-2:4.3.2+dfsg-1ubuntu1
FOUND: libexpat1-2.0.1-7ubuntu1
FOUND: libstdc++6-4.4.3-4ubuntu5
FOUND: libperl5.10-5.10.1-8ubuntu2
Checking for suggested prerequisites...
FOUND: perl-5.10.1
FOUND: sysstat
FOUND: sqlite3
Prerequisite check complete.
Checking for installable packages
Found zimbra-core
Found zimbra-ldap
Found zimbra-logger
Found zimbra-mta
Found zimbra-snmp
Found zimbra-store
Found zimbra-apache
Found zimbra-spell
Found zimbra-memcached
Found zimbra-proxy
Select the packages to install
Install zimbra-ldap [Y] ↵
Install zimbra-logger [Y] ↵
Install zimbra-mta [Y] ↵
Install zimbra-snmp [Y] ↵
Install zimbra-store [Y] ↵
Install zimbra-apache [Y] ↵
Install zimbra-spell [Y] ↵
Install zimbra-memcached [N] ↵
Install zimbra-proxy [N] ↵
12
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Checking required space for zimbra-core
checking space for zimbra-store
Installing:
zimbra-core
zimbra-ldap
zimbra-logger
zimbra-mta
zimbra-snmp
zimbra-store
zimbra-apache
zimbra-spell
The system will be modified. Continue? [N] y
Removing /opt/zimbra
Removing zimbra crontab entry...done.
Cleaning up zimbra init scripts...done.
Cleaning up /etc/ld.so.conf...done.
Cleaning up /etc/security/limits.conf...done.
Finished removing Zimbra Collaboration Suite.
Installing packages
zimbra-core......zimbra-core_7.1.3_GA_3346.UBUNTU10_64_amd64.deb...done
zimbra-ldap......zimbra-ldap_7.1.3_GA_3346.UBUNTU10_64_amd64.deb...done
zimbra-logger......zimbra-
logger_7.1.3_GA_3346.UBUNTU10_64_amd64.deb...done
zimbra-mta......zimbra-mta_7.1.3_GA_3346.UBUNTU10_64_amd64.deb...done
zimbra-snmp......zimbra-snmp_7.1.3_GA_3346.UBUNTU10_64_amd64.deb...done
zimbra-store......zimbra-store_7.1.3_GA_3346.UBUNTU10_64_amd64.deb...done
zimbra-apache......zimbra-
apache_7.1.3_GA_3346.UBUNTU10_64_amd64.deb...done
zimbra-spell......zimbra-spell_7.1.3_GA_3346.UBUNTU10_64_amd64.deb...done
Operations logged to /tmp/zmsetup.11102011-084512.log
Installing LDAP configuration database...done.
Setting defaults...No results returned for A lookup of server01.localdomain
Checked nameservers:
192.168.83.50
DNS ERROR resolving server01.localdomain
It is suggested that the hostname be resolveable via DNS
Change hostname [Yes]
Please enter the logical hostname for this host [server01.localdomain]
mail.govhosting.com
MX: mail.govhosting.com (192.168.83.50)
Interface: 192.168.83.50
Interface: 192.168.83.55
Interface: 192.168.83.56
Interface: 127.0.0.1
192.168.83.50
done.
Checking for port conflicts
Port conflict detected: 80 (zimbra-store)
13
© April 2007, Kefa Rabah, Global Open Versity, Vancouver Canada
www.globalopenversity.org ICT105 – Ubuntu Server Administration Training
Global Open Versity, ICT Labs Mastering Zimbra Deployment on Ubuntu 10.04 LTS
Port conflict detected: 443 (zimbra-store)
Port conflicts detected! - Any key to continue
Main menu
1) Common Configuration:
2) zimbra-ldap: Enabled
3) zimbra-store: Enabled
+Create Admin User: yes
+Admin user to create: admin@mail.govhosting.com
******* +Admin Password UNSET
+Anti-virus quarantine user: virus-
quarantine.6g6ghz3ag@mail.govhosting.com
+Enable automated spam training: yes
+Spam training user:
spam.dwjvc6ogp@mail.govhosting.com
+Non-spam(Ham) training user:
ham.avgu4mm3@mail.govhosting.com
+SMTP host: mail.govhosting.com
+Web server HTTP port: 80
+Web server HTTPS port: 443
+Web server mode: